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Preface 



This publication is intended for all users of VM/PC. It 
assumes a general knowledge of the VM operating 
environment. This publication has two sections: 

1 . Chapters 1 through 5 contain basic information to 
help you start using VM/PC. 

2. Chapters 6 through 8 and the Appendixes contain 
more specialized and reference information. 

"How to Use This Book" on page 1-6 describes the 
layout of this book in greater detail. 

If you are not familiar with using VM/SP or something 
similar, you may want to order the IBM publication 
Virtual Machine /Personal Computer Primer, part 
number 6024176 (AAS feature number 4176), from 
your IBM Marketing Representative. This Primer is 
intended for beginning users. It provides many 
examples of basic usage. 

VM/PC Version 1.1 is based upon VM/SP Release 3. 
It may be necessary to reference some VM/SP 
publications to find further reference information for 
VM/PC. Appendix B, "Comparison of VM/PC and 
VM/SP" on page B-l provides information about 
where to find further information in the VM/SP 
library, and gives the Titles and Order Numbers for the 
VM/SP books. 

We use the term 3270 in this book to denote emulation 
of a 3277-2, a 3278-2, or a 3279-S2A. The hardware 
you have determines which terminal your Personal 
Computer emulates. 



in 



When you see text printed in this color it indicates 
either: 

1 . This is the first occurrence of a term defined in the 
glossary. 

2. This is a user entry (for example, a command). 

The Virtual Machine/Personal Computer program 
diskettes are packaged at the back of the Service Aids 
publication shipped with this product. 
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Chapter 1. Introduction to VM/PC 



VM/PC is an IBM licensed program product which 
runs on the IBM Personal Computer models XT/370 or 
AT/370. VM/PC runs as an IBM Personal Computer 
Disk Operating System application and presents you 
with an interactive system which has the characteristics 
of a VM/SP Release 3 system. These characteristics 
include command entry, command format, messages, 
screen formats, data file naming conventions, key 
functions, and application interfaces. 

VM/PC allows you: 

• To set up your system quickly via a series of easy to 
use panels which guide you through the installation 
and configuration process. 

• To establish a local 370 environment in your IBM 
Personal Computer XT/370 or AT/370. 

• To manage a single virtual memory space of up to 4 
million characters on an XT/370, or 8 million on an 

AT/370. 

• To select the type of connection (3270 or 3101) to 
a host computer that meets your processing needs. 

• To maintain concurrent local and host sessions over 
the 3270 Coaxial Connection or EIA RS232-C 
communication facilities (hereafter referred to as 
RS232). 

• To transfer data and programs between your host 
VM computer and your IBM Personal Computer 
XT/370 or AT/370. 
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To execute many 370 CMS applications in your 
IBM Personal Computer XT/370 or AT/370 
without modification. 

To transfer your VM/PC data files between the 
VM/PC format and IBM Personal Computer Disk 
Operating System (hereafter referred to as DOS). 
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What You Need 



The minimum requirements of VM/PC are: 

• IBM Personal Computer XT/370 or AT/370. 

• The IBM Personal Computer Disk Operating 
System reference manual and diskettes at the 
proper level for your Personal Computer model. 

Note: An XT/370 requires DOS version 2. 10 or 
equivalent, but an AT/370 requires DOS version 
3.00 or equivalent. 

• An IBM Monochrome Display or any other 
compatible monitor designed to display 25 lines of 
80 columns each. 

• One diskette drive. 
Notes: 

1 . Model XT/ 3 70 only supports 3 6 OK diskettes; 
model AT/370 supports 360K or 1200K 
diskettes. 

2. Diskettes written on an XT/ 370 can be used on 
an AT/ 370, but diskettes written on an AT/ 370 
cannot be used on an XT/ 3 70. 

• One fixed disk. 

Note: Model XT/370 has 10 megabyte fixed disks; 
model AT/370 has 20 megabyte fixed disks. 

VM/PC also supports the following: 

• An IBM Matrix Printer or any compatible printer. 
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A second fixed disk drive, if more fixed disk storage 
is required. 

A second diskette drive, if more diskette storage is 
required. 

Note: An AT/370 supports up to 3 drives. You 
may have 2 diskette and 1 fixed drives, or 1 diskette 
and 2 fixed drives, or 1 of each. 

An IBM Asynchronous Communication Adapter 
and the IBM 3101 Emulation Program (6024042), 
if asynchronous communications is desired. 

An IBM 3270 Device Emulation Adapter, if 3270 
Coaxial Connection communications is desired. 

Note: In this book we use the term 3270 to denote 
emulation of a 3277-2, a 3278-2, or a 3279-S2A. 
The hardware you have determines the kind of 
terminal your Personal Computer emulates. 

— If you have a 3277-2 Device Emulator Adapter 
(only available with an XT/370), you emulate a 
3277-2 over a coaxial connection. 

— If you have a 3278/79 Emulation Adapter 
(available with either an XT/370 or an 
AT/370) and a monochrome display, you 
emulate a 3278-2 over a coaxial connection. 

— If you have a 3278/79 Emulation Adapter and 
a Color/Graphics Display Adapter, you emulate 
a 3279-S2A over a coaxial connection. 

More information on these terminal emulations are 
given in Chapter 4, "Getting Started" on page 4-1. 

Use of Expansion Random Access Memory in an 
AT/370. For further information on Expansion 
RAM see the IBM Personal Computer AT/ 370 
Guide to Operations. For examples of how to use 
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this Expansion RAM with VM/PC, see "Using 
AT/370 RAM with VM/PC" on page C-4. 
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How to Use This Book 



We have assumed that you have a general knowledge of 
the VM operating environment. Take the time to read 
this manual to gain a more detailed understanding of 
the VM/PC system and its relationship to the host VM 
system and to the IBM Personal Computer XT/370 or 
AT/370 on which it resides. 

Note: If you are a beginner at system usage, you may 
want to start by reading the Virtual Machine / Personal 
Computer Primer, part number 6024176 (AAS feature 
number is 4176). You may order this publication 
through your IBM Marketing Representative. 

All users should read these parts of this book 

Introduction 

Configuring 

Getting Started 

Using Commands to Do Work 

Commands (for reference) 

Messages (for reference) 

Glossary (for meanings of terms and acronyms) 

Index (to help find information). 

All users who have to do the specific tasks named 
should read these parts: 

• Installing 

• Host Services (if installing Host Services Program - 
VMPCSERV). 

Users with the specific needs named should read these 
parts: 

• Host Services (those needing more information on 
linking Host and Local sessions) 
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• CP/CMS Interface (those interested in Internal 
Processing) 

• Comparison of VM/SP and VM/PC (those familiar 
with VM/SP) 

• Operating Hints (those interested in System 
Operation) 

• ASCII to EBCDIC Conversion (those interested in 
data representation) 

• Distribution Diskette Contents (those interested in 
file names). 

If you want further information about using VM/PC, 
you must consult the appropriate VM/SP Release 3 
publications. The names and order numbers for those 
publications are listed in "Order Numbers for VM/SP 
Release 3 Books" on page B-10. Note that you must 
use the special order numbers given there to order those 
books to ensure that you get the correct-level manuals. 
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The VM/PC System 



After you start the VM/PC application, you have the 
option of selecting the type of connection that meets 
your processing needs. You can: 

• Connect to a host computer as a 3270 or a 3 101 
terminal. This computer does not have to be located 
in your immediate area. This type of connection is 
called a 'host' session, or 

• Connect to the local computer in the IBM Personal 
Computer XT/370 or AT/370 and run the local 
VM/PC system. This type of connection is called a 
'local' session, or 

• Connect to a host computer and the local computer 
at the same time and maintain 'concurrent' host and 
local sessions. 

If you select concurrent host and local sessions, you 
can: 

— Maintain up to three separate and distinct 
sessions, that is, a local VM/PC session and 
two host sessions with any computer system 
that supports 3270 or 3101 data streams, or 

— Combine the local and the host 3270 sessions 
into a single processing environment and allow 
data sharing between your IBM Personal 
Computer and your host computer. In this case, 
only the 3270 communication facilities can be 
used. The host system must be an IBM VM/SP 
system on which the Host Services program 
(VMPCSERV) has been installed. This 
installation process is described in Chapter 

6, "Host Services" on page 6-1. 
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The selection of these options is described in Chapter 
4, "Getting Started" on page 4-1. 
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Using Local VM/PC Services 



Several people can share the 370 system but only one 
person can use it at a time. If many users have access to 
your IBM Personal Computer XT/370 or AT/370, you 
can control access to VM/PC and to each users' data. 
This process is described in Chapter 3, " Configuring 
Your VM/PC System" on page 3-1. 

If you are familiar with VM on a 3270 Display, you will 
at once notice the differences between that keyboard 
and the IBM Personal Computer keyboard. The 
VM/PC key selection closely adheres to the function of 
the key on the IBM Personal Computer. The VM/PC 
keyboard layout is described in Chapter 4, " Getting 
Started" on page 4-1. 

VM/PC commands are format compatible with VM 
systems. Some commands and options have been 
modified or deleted to accommodate the IBM Personal 
Computer XT/370 or AT/370 environment. Some 
commands and options have been added for the same 
reason. The CP and CMS commands are described in 
Chapter 7, "VM/PC Commands" on page 7-1. 
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Using Host VM Services 



As mentioned above, you can combine your host 3270 
VM session with your local session into a single 
environment. This will allow you to use some of the 
resources of your host system as if they were attached 
to your local VM/PC session. After you start the Host 
Services program, called VMPCSERV, in your host 
VM session, you can, in your local session: 

• Print files on your host VM system's printers 

• Gain access to any CMS i^iiKiisLi on your host 
VM system 

• Transfer Personal Computer DOS files to your host 
VM system. 

The VMPCSERV program allows you to spool your 
print output to your host virtual printer so any printing 
done on your local session will be sent to your host 
virtual printer. This gives you access to high speed 
printers. You can also tag the print files to send them to 
other printers in your VM network. Conversely, you 
can print files from your host VM system on your local 
Personal Computer printer. This provides you privacy 
and quick output. 

The VMPCSERV program also allows you to link and 
access CMS minidisks that are located at your host VM 
system. This allows you to: 

• Run programs that are on minidisks attached to 
your host system 

• Copy files from your host system for use on your 
local system 
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• Copy files from your local system for use on your 
host system. 

Note: You must have a license from IBM in order to 
use Host-resident IBM programs on your personal 
computer. See your IBM representative for details. 

Earlier we said you could transfer Personal Computer 
DOS files to your local VM/PC system. With the 
VMPCSERV program, you can transfer the DOS files 
to your host VM system. As an example, you could: 

1. Create DOS files on an IBM Personal Computer, 
perhaps at home, and store the files on a diskette 

2. Place the diskette in your XT/370 or AT/370 and 
use the VM/PC command IMPORT to copy the 
files to your local and/or your host VM system, 

3. Print them, or forward them, or modify them as you 
would any CMS file. 

Note: The above example can be reversed by using the 
VM/PC command EXPORT instead of IMPORT. 

See Chapter 6, "Host Services" on page 6-1 for more 
information on using the host server program, 
VMPCSERV, to gain access to the resources of your 
host VM system. 

See "Transferring Personal Computer DOS and 
VM/PC Files" on page 5-62 for examples of 
transferring Personal Computer DOS files to VM/PC. 
See "EXPORT" on page 7-109 and "IMPORT" on 
page 7-138 for descriptions of the commands used to 
transfer files from and to VM/PC. 
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Chapter 2. Installing VM/PC 



About This Chapter 



The program files and data files that make up the 
VM/PC product are stored on seven diskettes that you 
can find at the back of the Service Aids book. You will 
have to move many of those files onto your system 
before you can use the functions they provide. The 
process of moving the needed files to your system is 
called "installation." 

In this chapter, we will cover these topics dealing with 
installation: 

• We will take you through a list of things that need 
to be checked before beginning the installation 
process. 

• We will ask you to make backup copies of your 
VM/PC Distribution Diskettes. 

• We will guide you step-by-step through the 
VM/PC installation process. As you go through 
each step, you may need to make some choices 
about files already on your system. If so, we will 
tell you what you need to consider in making each 
choice. 

Note: If you are upgrading from VM/PC Version 
1 and intend to reuse your CONFIG. 1VM file, you 
must read "What About Existing Files?" on 
page 2-22. 
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We will tell you about the amount of space on your 
fixed disk(s) that VM/PC needs during installation 
and afterward. 

We will tell you what to do if, for some reason, 
something goes wrong during the installation 
process. 

We will tell you how to repeat the installation 
process. You will want to know this if something 
goes wrong during installation or if the copy of 
VM/PC you installed on your fixed disk becomes 
damaged. 

Note: See Appendix E, ' 'Distribution Diskette 
Contents" on page E-l for a list of the files 
contained on the distribution diskettes. 
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Before You Begin 



The VM/PC installation process is designed to make it 
easy for you to use. There are, however, several things 
you need to check before you begin: 

• First of all, make sure that you are installing 
VM/PC on a computer system satisfying the 
hardware and software requirements described in 
the previous chapter. In particular, before 
beginning the installation of VM/PC, you should 
have completed the installation of the Personal 
Computer XT/370 or AT/370 and DOS as 
described in the Personal Computer XT/ 3 70 Guide 
to Operations or the Personal Computer AT/ 370 
Guide to Operations and the Personal Computer Disk 
Operating System manuals. If this has been done, 
your fixed disk (the C disk) will have been 
formatted by DOS and will contain the Personal 
Computer XT/370 or AT/370 Personality file 
(IMLPU.1VM). 

• A fixed disk on your system will be used as "the C 
disk" during the installation process. The disk 
should contain DOS, as many of its commands and 
services will be used to install VM/PC. You may 
need to refer to the manual supplied with DOS. 

Note: The VM/PC installation process always uses 
only one fixed disk (the C disk). You may have a 
system with two fixed disks. If so, you can direct 
the installation to your D disk prior to beginning the 
installation process. To do this, issue the DOS 
command: 

ASSIGN C=D 
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Following installation, the ASSIGN command can 
be used whenever you wish to use VM/PC. If you 
want to run VM/PC from your D disk without 
using the ASSIGN command, or if you want 
VM/PC to use both of your fixed disks, read 
Chapter 3, "Configuring Your VM/PC System" 
on page 3-1. 

• Next, make sure that VM/PC needs to be installed. 

If you are sharing your computer with others who 
may already be using VM/PC, ask them if you need 
to install VM/PC. You may only need to add some 
information to certain existing files to begin using 
the VM/PC system yourself. 

If you are the first person to use VM/PC on your 
computer, you will have to follow the installation 
procedure in this chapter. Otherwise, you can skip 
this chapter and go to Chapter 3, "Configuring 
Your VM/PC System" on page 3-1, for 
information on adding users to a VM/PC system. 

• Next, make sure you have all the diskettes you will 
need. 

You will need all seven of the VM/PC Distribution 
Diskettes found at the back of this manual. 

• Find out how much unused space is available on 
your C disk. You can do this by using the DOS 
commands CHKDSK or DIR. If you do not have at 
least 2,300,000 bytes of available space, you should 
read "How Much Disk Space Is Required?" on 
page 2-18 before continuing. 

Once you have satisfied the items to be checked, you 
are ready to make your backup copy of the VM/PC 
Distribution Diskettes. 
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Copying VM/PC to Backup Diskettes 



We strongly recommend that you make backup copies 
of all seven VM/PC diskettes (provided with this 
manual) before you copy them onto your system. If a 
diskette somehow becomes damaged, or if files are 
accidentally erased, you will still have all your 
information. 

The backup procedure is described in your Personal 
Computer Disk Operating System manual under the 
heading "Backing Up a Diskette." When you backup 
your diskettes, it may be helpful to refer to Appendix 
E, "Distribution Diskette Contents" on page E-l. 
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Copying VM/PC to Your System 



Before giving you detailed instructions, you should have 
a general idea of what the process of copying VM/PC 
to your system involves. 

Basically, you: 

• Insert one of the VM/PC Distribution Diskettes in 
drive A 

• Type the name of a VM/PC installation program 
that, after you press ENTER, takes over the 
installation process and tells you what to do next 

• Answer any questions displayed on your screen by 
the program 

• And, finally, insert in drive A the remaining 
VM/PC Distribution Diskettes as requested by the 
installation program. 

If you have satisfied the items listed in "Before You 
Begin," the entire installation process (which we 
describe in fourteen steps) often takes less than ten 
minutes. 

When you are ready, bring up your DOS (You MUST 
boot from drive C) so that the "C" prompt appears on 
your screen; then follow these instructions: 

• STEP 1. Insert VM/PC Distribution Diskette 1 in 
drive A. 

This "Utilities" diskette contains the VM/PC 
installation program and several related files. 

• STEP 2. Type A:INSTALL and press ENTER. 
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INSTALL is the name of the VM/PC installation 
program. It uses DOS commands and a program 
written in Advanced BASIC to guide you through 
the rest of the installation process. 

If you wish, you can simply let the installation 
program lead you from here. If not, or if something 
happens you don't understand, you can read the 
rest of these instructions. 

- NOTE: 

If, at any time during installation processing, 
something happens that seems to be an error, or 
if a screen is presented that is not described in 
the step-by-step instructions, refer to "If 
Something Goes Wrong?" on page 2-25. 

After you press ENTER, the installation program 
displays a logo screen and asks you to press 
ENTER to continue. 

STEP 3. Press ENTER. 

After pressing ENTER, the installation program 
makes sure that the files it needs are on your C 
disk. The program also checks to see if you are 
already using files that have the same names as it 
intends to use temporarily during the installation 
process. If everything is alright, it copies several 
temporary files from the distribution diskette to 
your C disk, and you see: 
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IBM V M / P C 

INSTALLATION PROCEDURE MESSAGE 

The installation process has completed its preliminary checking of your 
system. So far, everything is in order. 

Several temporary files will now be copied to your C disk. These files 
will be used to continue the installation process. 

DO NOT REMOVE the diskette in drive A until told to do so. 
After reading this message, press ENTER. 



After you see the above screen, continue with STEP 
4. 

If, instead of the awaited screen, you see the 
following screen: 
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IBM VM/PC INSTALLATION 

INSTRUCTIONS FOR EXISTING FILES 

Your C disk already has one or more files with the same name as a file 
needed during VM/PC installation. 

The next screen you will be shown is a list of the EXISTING file(s) that 
you may wish to SAVE. 

For each EXISTING FILE, you will have to choose one of three actions: 

SAVE the file - a new file with same name will NOT be installed. 

RENAME the file - the EXISTING file will be given a new name (which 
you supply), and a new file will be installed. 

REPLACE the file - a new file with same name WILL be installed. 

You will also be given a chance to QUIT (if you need to study your 
choices) . 

To see the list, press ENTER. 



then you will need to make some choices about files 
already on your C disk. This DOES NOT MEAN 
anything has gone wrong. The installation program 
will help you with your choices, but you will have to 
refer to "What About Existing Files?" on 
page 2-22 for the instructions you need. 

STEP 4. Press ENTER. 

After pressing ENTER, you will see the names of 
the temporary files as they are copied to your C 
disk. Next, the following screen will appear: 
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IBM VH/PC 
INSTALLATION PROCEDURE MESSAGE 
Please remove any diskette now in drive A. 
Insert the following VM/PC distribution diskette into drive A: 



VM/PC Control Program 



To continue, press ENTER. 

(If you wish to bypass this diskette, press 'B 1 .] 



After the screen appears, continue with STEP 5. 

STEP 5. Insert the requested diskette in drive A and 
press ENTER. 

The installation program will then copy the files 
from the diskette to your C disk and you will see 
these messages: 



C>C0PY 


A:C0NFIG.1VM C:/V 




1 Fi le(s) copied 


C>C0PY 


A:VMPC.C0M C:/V 




1 Fi le(s) copied 


C>C0PY 


A:CPI0.1VM C:/V 




1 Fi le(s) copied 


C>C0PY 


A:CP.1VM C:/V 




1 Fi le(s) copied 


C>C0PY 


ArCPMSG.IVM C:/V 




1 Fi le(s) copied 


C>ECH0 


OFF 



After the above messages appear, go to STEP 6. 
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If you cannot find the requested diskette, or if you 
have changed your mind about installing VM/PC at 
this time, just press the 'B' key. 

The installation program will then show you this 
screen: 











IBM VM/PC INSTALLATION 














* * * 
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2 BYPASS * 


* * 




You have 


chosen 


to 


BYPASS 


installation processing 




for 


VM/PC 


distr 


ibut 


ion a" 


skette 2 








If 


you are sure 


you 


wish 


to do so 


press B 


again, 


and 


no 


VM/PC 


f unct i 


ons 


will be loaded 


from the d 


skette 




If 


you w' 


sh to 


return to 


the previous screen 


, press 


ENTER. 



This ensures that you do not bypass the diskette 
accidentally. 

If you still wish to bypass the diskette, just press 'B' 
again, and you will prevent the copying of any files 
from the requested diskette. Your decision to 
bypass will NOT AFFECT installation processing 
for any other distribution diskettes. 

If you decide not to bypass, just press ENTER and 
you are back at the start of STEP 4. 

STEP 6. Wait for the following screen to appear: 
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IBM VH/PC 
INSTALLATION PROCEDURE MESSAGE 
Please remove any diskette now in drive A. 
Insert the following VM/PC distribution diskette into drive A: 



VM/PC CMS 



To continue, press ENTER. 

(If you wish to bypass this diskette, press 'B'.) 



After the screen appears, continue with STEP 7. 

STEP 7. Insert the requested diskette in drive A and 
press ENTER. 

The installation program will then copy the files 
from the diskette to your C disk and you will see 
this message: 



OCOPY A:CMS.1VM C:/V 

1 Fi le(s) copied 

C>ECH0 OFF 



After the above message appears, go to STEP 8. 

As in STEP 5, you can bypass this step by pressing 
the 'B' key. 
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STEP 8. Wait for the following screen to appear: 



IBM V M / P C 
INSTALLATION PROCEDURE MESSAGE 
Please remove any diskette now in drive A. 
Locate the following four VM/PC distribution diskettes ... 



VM/PC Library (backup 


diskette 01 ) 




k 










VM/PC Library (backup diskette 


02) 


5 












VM/PC Library (backup dis 


kette 03) 




6 








VM/PC L 


brary (backu 


p diskette 


0*4 ) 


7 



These diskettes contain ONE large file which will be moved to your C disk 
automatically using the 'RESTORE 1 command, which will ask for the four 
diskettes (in order) using the names ... 

'backup diskette 01', 'backup diskette 02', 'backup diskette 03', 

and 'backup diskette 0k ' . 
When you are ready with these four diskettes, press ENTER. 



After the screen appears, locate the four requested 
distribution diskettes. You will notice that you have 
not yet been told to insert any of the four diskettes 
into a diskette drive. The screen was shown to 
prepare you to properly respond to future prompts 
from the DOS RESTORE command. The 
RESTORE command will soon be used to create a 
single file on your C disk from data previously 
stored (using the DOS BACKUP command) on the 
four VM/PC Distribution Diskettes 4, 5, 6, and 7. 
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- NOTE: 

You may wish to read the description of the 
RESTORE command in the DOS manual before 
continuing. 

After locating ALL FOUR diskettes, go to STEP 9. 

STEP 9. Press ENTER. 

After you press ENTER, the installation program 
invokes the RESTORE command. Then you will 
see: 



Insert backup diskette 01 in drive A: 
Strike any key when ready 



When you see the above prompt, insert VM/PC 
Distribution Diskette 4 in drive A and go to STEP 
10. 

STEP 10. Press any key. 

- NOTE: 

When we say "any key," we mean "any key or 
combination of keys that generates a 
character." This meaning is used consistently 
by DOS. 

After moving the data on the diskette in drive A to 
the C disk, the RESTORE command prompts you 
for the next distribution diskette. You will see: 
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Insert backup diskette 02 in drive A: 
Strike any key when ready 



When you see the above prompt, insert VM/PC 
Distribution Diskette 5 in drive A and go to STEP 
11. 

STEP 1 1 . Press any key. 

After moving the data on the diskette in drive A to 
the C disk, the RESTORE command prompts you 
for the next distribution diskette. You will see: 



Insert backup diskette 03 in drive A: 
Strike any key when ready 



When you see the above prompt, insert VM/PC 
Distribution Diskette 6 in drive A and go to STEP 
12. 

STEP 12. Press any key. 

After moving the data on the diskette in drive A to 
the C disk, the RESTORE command prompts you 
for the next distribution diskette. You will see: 



Insert backup diskette 0^ in drive A: 
Strike any key when ready 
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When you see the above prompt, insert VM/PC 
Distribution Diskette 7 in drive A and go to STEP 
13. 

• STEP 13. Press any key. 

After moving the data on the diskette in drive A to 
the C disk, the RESTORE command processing is 
complete. Go to STEP 14. 

• STEP 14. Wait for the following screen to appear: 



IBM VM/PC 




INSTALLATION PROCED 


URE MESSAGE 


The VM/PC installation processing is near 


y complete. 


When you see the standard prompt from DOS 


» 


the VM/PC installation processing will be 


complete. 



After the screen appears, wait for the DOS prompt 
to appear. When you see the prompt, the VM/PC 
installation process is complete. You may remove 
any distribution diskette still in drive A. 

Now that you have completed the installation process, 
you may begin to use the VM/PC functions. The 
instructions you will need to do that are found in 
Chapter 4, "Getting Started" on page 4-1. 

You will not need to use any of the VM/PC 
Distribution Diskettes again until you are ready to use 
the Host Server functions described in Chapter 
6, "Host Services" on page 6-1. 

The remainder of this chapter deals with information 
that you will need only if something went wrong or if 
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you simply want to understand more about the 
installation process. 
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How Much Disk Space Is Required? 



The amount of space on your fixed disk(s) required by 
VM/PC can be looked at in two ways: 

• How much space is needed to simply complete the 
installation process? 

• Once VM/PC is installed, how much additional 
space is needed? 



At Installation Time 

You will need just under 2,300,000 bytes of available 
space on your C disk to install VM/PC. This space is 
needed to store the VM/PC permanent files for as long 
as you wish to have them resident on your system. 

You can determine the available space on your C disk 
by using DOS commands (CHKDSK or DIR). 

If you attempt to install VM/PC on a system having 
too little available disk space, the installation process 
will not complete. 

If you intend to run the Host 3101 Session, you will 
need to also install the IBM 3101 Emulation Program 
Product, which has disk space requirements that must 
be added to those of VM/PC. 



( 
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After Installation 



Three of the four VM/PC sessions can be used 
immediately after installation without requiring 
additional disk space. These three sessions are: 

• The Host 3270 Session 

• The Host 3101 Session 

• The 370 Processor Control Session. 

To use the Local 3270 Session, you will need to have 
enough disk space for three things: 

• Your 370 Virtual Machine Paging Activity 

When you use the Local 3270 Session, you will be 
making use of "370 Virtual Machine" facilities. 
These facilities require disk space equal in size to 
the size of your "virtual machine." 

The size of your virtual machine can be as large as 4 
megabytes (4,194,304) on an XT/370 or 8 
megabytes (8,388,608) on an AT/370, but 1 
megabyte (1,048,576 bytes) or even 512K bytes 
(524,288 bytes) is enough for many users. 

• The VM/PC CMS Minidisks 

Users of the Local 3270 Session generally prefer to 
have collections of files available on their fixed 
disk(s). These collections of files are called "CMS 
Minidisks," and their sizes are determined by the 
amount of information the user wants to have 
available. 

A minidisk can be as large as 10 megabytes on an 
XT/370 or 20 megabytes on an AT/370 (an entire 
fixed disk), but minidisks of about 1 megabyte 
provide adequate space for many activities. 

As you will learn in Chapter 3, you can allow 
several users to share the space on the fixed disk(s). 
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Each of these users may wish to have their own 
minidisks. It is helpful to know, however, that it is 
possible for several users to use the same minidisk. 
Also, it is possible to define a minidisk on a 
diskette, in which case the maximum size of the 
minidisk is 354K for an XT/370 and 1200K (1.2 
megabytes) for an AT/370. 

• Printer Spooling Activity 

Users of the Local 3270 Session have the ability to 
tell VM/PC to print a file and, without waiting for 
the file to print, continue with other activities. This 
capability is called "printer spooling" and is 
accomplished by copying the files to be printed 
onto a disk until there is time to print them. As 
these files are printed, they are erased from the 
disk. 

You will want to leave some disk space free to allow 
for spooling your printer files. The kind of files you 
expect to be printing will determine your spooling 
space requirements. For many users, 100K or 
200K would be adequate. 

An example may be useful. Suppose you want to install 
VM/PC and use the Local 3270 Session. You want 
two minidisks; one of 1 megabyte and the other twice 
that size. You also intend to run programs that will 
require a virtual machine size of 1 megabyte. You 
further suppose that your printer spooling requirements 
will be nearly 200K bytes. Your disk space calculations 
could look something like this: 

VM/PC files (installation) 2,300,000 

Smaller minidisk 1,048,576 

Larger minidisk 2,097,152 

Virtual machine activity 1,048,576 

Printer spooling activity 200,000 

Disk Space Required = 6,694,304 

Under the assumptions of our example, about 
3,300,000 bytes of space would still be available on 
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your fixed disk for additional printer spooling space, for 
DOS and for other uses if you have a 10 megabyte 
XT/370 fixed disk. With a 20 megabyte AT/370 fixed 
disk, about 13,300,000 bytes would be available. 
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What About Existing Files? 



The VM/PC installation process will never write over 
one of your existing files without giving you a chance to 
prevent it. 

If the installation process discovers an existing file 
having the same name as a file it wants to write, the 
process will either terminate itself or give you a chance 
to decide what to do before continuing. 

The process terminates if the file it wants to write is 
just a temporary file used only during installation. The 
section on "If Something Goes Wrong?" discusses this 
situation. 

If the file the installation process wants to write is one 
of the permanent files that make up VM/PC, you will 
be presented with the "INSTRUCTIONS FOR 
EXISTING FILES" screen described in STEP 3. 

After reading the instructions, you should press any key 
to see a list of the files that already exist. The list looks 
like this: 
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EXISTING VM/PC FILES 




To choose an action for a file, use the ' f ' and ' | ' keys to move the 


'==>' pointer to 


the proper line. Then press a function key 




F1 - SAVE THE 


EXISTING FILE F9 - TO REVIEW INSTRUCTIONS 


F2 - RENAME THE EXISTING FILE F10 - QUIT 




F3 - REPLACE THE EXISTING FILE 




Press ENTER after all choices are complete. 




FILENAME- 


-_______rvccrD i DTir>w_-_ -ctatiic 




UtbLKIrl 1 UN blAlUb 




==> CONFIG. 1VM 


VM/PC CONFIGURATION FILE Action 


Required 


VMPC.COM 


VM/PC PROGRAM Action 


Required 


CPI0.1VM 


VM/PC CP I/O SERVICES Action 


Required 


CP.1VM 


VM/PC CP 370 NUCLEUS Action 


Required 


CPMSG.1VM 


VM/PC CP MESSAGE FILE Action 


Required 


CMS.1VM 


VM/PC CMS PROGRAM Action 


Required 


CMS. 100 


VM/PC CMS SYSTEM LIBRARY Action 


Required 


VMPCC0N.EXE 


VM/PC CONFIGURATOR PROGRAM Action 


Required 



The list will show only the files that exist, so the list you 
see may not include all eight of the VM/PC permanent 
files. 

You will have to follow the instructions on the list 
screen (or refer to the instructions screen using the 'F9' 
key) and decide about each file on the list. 

You will want to 'SAVE' a file if it is used by VM/PC 
and contains information that should NOT be 
over- written during the installation process. An 
example of such a file is the Configuration File 
(CONFIG. 1VM). If you have already set one up for 
your system, you will probably want to 'SAVE' it. 

Note: If you install VM/PC Version 1.1, but save the 
CONFIG. 1VM file from Version 1, you must edit the 
Configurator file and change the Size of Minidisk value 
for the 100 disk of User CMS from 2048 to 2300. 

You will want to 'REPLACE' a file if it is used by 
VM/PC but contains information that you are willing 
to have over-written by the installation process. 
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You will want to 'RENAME' a file if it is NOT to be 
used by VM/PC and it contains information that 
should NOT be over-written during the installation 
process. 

Decisions to 'REPLACE' a file and to 'SAVE' a file are 
not acted upon until you complete the list, so they can 
be changed as often as you like prior to pressing 
ENTER. 

However, decisions to 'RENAME' a file are handled 
differently. After pressing the 'F2' key, you will be 
prompted for the new name to be assigned the existing 
file. Once you enter the new name, the installation 
program attempts to rename the file immediately. If 
the rename attempt fails, you will see an explanatory 
message. If the rename attempt succeeded, the status 
field on the list will be changed to 'RENAMED'. Once 
a file has been successfully renamed, you cannot use the 
list screen to 'RENAME' it again. Also, the installation 
program will not let you use the 'RENAME' key to 
change the name of one of your existing files to a name 
that is already in use. 

When you have made a decision for each file on the list 
screen, you press the ENTER key to notify the 
installation process that it can proceed. The installation 
process will change itself (if necessary) to prevent the 
installation of the files you chose to 'SAVE'. For this 
reason, some of the step-by-step instructions described 
above may be bypassed. 
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If Something Goes Wrong? 



The VM/PC installation process is designed to be 
trouble free. In the step-by-step instructions above, we 
have talked about the screens you are expected to see 
and the actions you are supposed to take when 
everything goes as intended. 

If, for whatever reason, something happens that you 
cannot find described earlier in this Chapter, we 
suggest you read this section. If you cannot find the 
explanation you need here, or elsewhere in this manual, 
refer to the Personal Computer XT/ 3 70 Guide to 
Operations or Personal Computer AT/ 3 70 Guide to 
Operations manual. 
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DOS Facilities Missing 

If you see this screen: 
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you need to review the list of items that must be 
checked before beginning the installation process (in 
the ''Before You Begin" section earlier in this chapter). 
After doing so, start the installation process over again 
at STEP 1. 
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VM/PC Temporary Files Already Exist 

If you see this screen: 



IBM VM/PC 

INSTALLATION PROCEDURE MESSAGE 

During the installation process, several small files will be created 
temporarily on your C disk. 

These temporary files will be erased automatically at the end of the 
installation process, but the file names used may conflict with 
exi st ing f i les. 

The installation process found the following existing files with the 
same names as those to be used for temporary files: 

TVMPC.DSK TVMPCHD.MSG TVMPCDD2.BAS TVMPC01.BAS 
TVMPCLC.BAT TVMPC01.MSG TVMPCDD3-BAS TVMPC03.BAS 
TVMPC03.MSG TVMPCDD4.BAS TVMPCDD7.BAS TVMPC.100 

To avoid possible damage to your existing files, you must either rename 
or remove them using DOS commands such as RENAME, COPY, ERASE etc. 
After doing so, you may restart the installation process. 



you must use the appropriate DOS facilities (COPY, 
RENAME, BACKUP, ERASE etc.) to remove any 
conflicting filenames. After the names are removed, 
you can restart the installation procedure at STEP 1 . 

Note: The screen you see may not contain all of the 
file names shown. 
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Insufficient Space on C Disk 

If there was not enough free space on your C disk to 
install the VM/PC functions, you will see: 









IBM VM/PC 
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DURE 
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* * * INSUFFICIENT FIXED DISK 


SPACE * * 


* 














The installation process 


DID NOT 


COMPLETE. 










2,300 
are r 


,000 bytes of C disk storage 
equired to install your VM/PC files 




















That amount of free storage is 


NOT avai lable on 
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C 


d 
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After reading this message, 


press 


ENTER. 











If you see the previous screen, the installation process 
has failed. You will have to use the facilities provided 
by DOS to make sufficient space available. Before 
doing so, you should read "How Much Disk Space Is 
Required?" on page 2-18. After sufficient space is 
made available, read "Repeating the Installation 
Process" on page 2-31. Then repeat the installation 
process. 

Note: You may see a value other than 2,300,000 
appear on your screen. This can happen because the 
Installation Program calculates the storage required 
based on your needs. 
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Unable to Read Space Available on C Disk 

If, for some reason, the installation program was unable 
to read how much free space is on your C disk, you will 
see: 



IBM VH/PC 
INSTALLATION PROCEDURE MESSAGE 
* * * UNABLE TO READ FREE SPACE ON FIXED DISK * * * 
The installation process DID NOT COMPLETE. 
After reading this message, press ENTER. 



If you see the previous screen, the installation process 
has failed. Before you can attempt to install VM/PC 
again, you will have to make sure your C disk is 
properly prepared. The list of items to check at the 
beginning of this chapter should help, as should the 
DOS CHKDSK command. When you are satisfied that 
your C disk is ready, you should read "Repeating the 
Installation Process" on page 2-31. Then repeat the 
installation process. 
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VM/PC Distribution Diskette Not Used 

If you are the first to install VM/PC on your system, 
then all seven of the VM/PC Distribution Diskettes 
will be used by the installation process. If you are the 
first to install VM/PC and not all seven diskettes were 
used, then there is reason to suspect something has 
gone wrong. In that case, you should review the items 
listed at the beginning of this chapter. If everything on 
the list is satisfied, attempt to repeat the installation 
process (after reading "Repeating the Installation 
Process" on page 2-31). 

If the problem persists, refer to the Personal Computer 
XT/ 3 70 Guide to Operations or Personal Computer 
AT/ 370 Guide to Operations manual. 

On the other hand, if you are not installing VM/PC on 
your system for the first time, it is likely that you 
needed to make choices about existing files (see STEP 
4 and "What About Existing Files?" on page 2-22). 
Those choices can result in the skipping of one or more 
of the VM/PC Distribution Diskettes by the 
installation process. If so, everything is fine, and you 
simply follow the step-by-step instructions as if the 
steps involving the unused diskettes were not there. 
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Repeating the Installation Process 



For whatever reason, if it becomes necessary to repeat 
the VM/PC installation process, the following 
information will be useful: 

• The installation process uses several temporary files 
which it erases upon normal completion. If the 
installation process failed or was ended before it 
completed, several of these temporary files may still 
be on the C disk. These files MUST be erased prior 
to repeating the installation process, since the 
installation program will not overwrite any of your 
existing files. 

All of the temporary file names begin with 
TVMPC. By issuing the DOS command: 

D l R TVMPC*.* 

you can determine the presence of temporary files. 

• If VM/PC had been previously installed on your 
computer, or if the installation process had partially 
completed, all (or some) of the eight permanent 
files that are normally installed will still be on the C 
disk. 

It is not necessary to do anything about these 
permanent files before repeating the installation 
process. The installation program will detect their 
existence and give you a chance to decide what to 
do. Read "What About Existing Files?" on 
page 2-22 for more information. 

Incidentally, this ability of the installation program 
makes it convenient to re-install even a single 
VM/PC permanent file if the copy of that file on 
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your C disk becomes damaged. This is done by 
starting the installation process and, when 
eventually presented with the "EXISTING VM/PC 
FILES" list screen, pressing the SAVE key for all 
the files that are undamaged and the REPLACE 
key for any damaged files. If a file is severely 
damaged, it will not even appear on the list screen. 
Such severely damaged files will be re-installed 
automatically by the installation process. 
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Chapter 3. Configuring Your VM/PC 
System 



The Configuration File 

One of the files copied to your C disk when VM/PC is 
installed is called the Configuration file. It contains 
information about the way you want to use VM/PC 
and about the files and other resources you want 
VM/PC to use. 

This information, which is read every time you run the 
VM/PC sessions, includes the following: 

• The names of the VM/PC programs and files as 
well as the drive on which to find them. This gives 
you the ability to rename them or move them to a 
disk other than your C disk. 

Note: If you upgrade your Version 1 Configuration 
File, you must upgrade any references to other 
disks. 

• The names (USERIDs) of those allowed to use the 
Local 3270 Session 

• For each user named, 

— A password to prove identity 

— The size of the 370 virtual machine 

— The number and size of any minidisks owned by 
the user 
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— The names of other users' minidisks that the 
user needs to access (this is called "linking.") 

• The amount of printer spooling activity to expect 

• Which options and automatic features of VM/PC 
to use. 

Because of the information in the Configuration file, it 
is possible to have several people use the same VM/PC 
system without damaging each other's files. Also, a 
single minidisk can be shared by several users, making it 
unnecessary for each to have their own copy of 
common data. Of course, more than one person cannot 
use the system at the same time. 

To help you get started, the Configuration file installed 
with VM/PC contains a sample user name and other 
needed information. If you wish, you can use this 
Configuration file to become familiar with VM/PC. If 
so, go to Chapter 4, "Getting Started" on page 4-1 
now and postpone reading the rest of this chapter until 
you feel the need to modify the Configuration file. 

Since the Configuration file is so important to VM/PC, 
the information in the Configuration file must be 
accurate and consistent. For the same reason, when 
several users are using the same system it may be 
necessary to allow only one person to see or to change 
the Configuration file. To help ensure both the 
accuracy of Configuration file data and to prevent 
uncontrolled access to that data, VM/PC supplies you 
with the Configurator program. 
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The Configurator Program 



The Configurator is a specialized editor for the 
Configuration file. It guides you through the 
information on the file and allows you to display or 
modify whatever you want. With this editor you can 
define new CMS minidisks, extend old ones, define new 
VM/PC users, delete old ones, define your local printer 
spooling options, inform VM/PC of new system 
definitions, etc. 

The Configurator will also let you define a password so 
that only those who know the password can use the 
Configurator. 



Starting the Configurator Program 

The Configurator program runs directly under the 
control of DOS. So if you have installed VM/PC as 
instructed in Chapter 2, simply prepare your system so 
that the prompt of C> indicates that DOS is ready, and 
enter "VMPCCON." 

DOS will then load the Configurator program 
(VMPCCON.EXE) and the IBM logo and copyright 
screen will be displayed. 

Note: The Configurator program will always look for 
the Configuration file (CONFIG. 1VM) on the DOS 
default drive (that is, the C drive if the prompt is C>). 
The Configurator uses a work file named 
CONFIG.UT1. If you have a file by this name on the 
default drive, you will be prompted for permission to 
erase it. 
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Using the Configurator 

After starting the Configurator (which uses the 
standard Personal Computer keyboard layout), press 
the ENTER key to continue. 

You will see a message indicating that the Configurator 
is reading the Configuration file. 

Note: If, for whatever reason, the Configuration file 
does not exist, the Configurator will provide defaults 
from which you can build a new Configuration file. 
However, using the Configurator Program to modify a 
copy of the Configuration file supplied with VM/PC is 
often an easier way of building a new Configuration 
file. 

Before telling you how to work with specific 
Configurator screens, there is some general information 
about the way these screens are arranged, about the use 
of function keys, and about some of the other keys that 
you need to understand. 

Configurator Screens 

The screens presented by the Configurator program 
have much in common. Each has a title for easy 
reference by other screens. This is usually followed by 
a single line instruction such as "Make All Changes 
then Press ENTER." 

Most screens have three boxes. See Figure 3-3 on 
page 3-17 for a sample of a typical screen. 

The first box contains the "input areas," which are the 
only places on the screen you can change. The cursor 
only moves to the input areas within this box. 

The second box contains "help" information; (a brief 
explanation of the kinds of information to put in each 
input area). If there is not enough room to display all 
of the help information in the box, you may be directed 
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to press a function key to see expanded information on 
another screen. 

The third box describes any function keys you can use. 
Function Key Usage 

The FUNCTION MENU is considered the main screen 
presented by the Configurator. If you are viewing a 
later screen, pressing function key 3 (F3) will return 
you to the FUNCTION MENU screen. There you can 
start a new function if you desire. Pressing function 
key 5 (F5) returns you to the screen specified in the 
Function Key definition box on the current screen. 
This is nearly always the previous screen. 

In general, you must press ENTER to apply the 
changes you have made on any screen. 

If you press a function key to return you to another 
screen without first pressing the ENTER key, the 
changes on that screen will NOT be made. The 
Configurator assumes that you changed your mind 
regarding the changes. 

Function keys 7 and 8 (F7 and F8) are the scrolling 
keys. If pressed while viewing a particular screen, they 
will scroll you forward or backward to the next user, 
minidisk, or link, as indicated by the function key area 
on the screen. 

Keyboard Usage 

As we mentioned above, only one box on the screen 
contains input areas. These input areas are the only 
places on the screen where the cursor can be 
positioned. 

As you type or try to move the cursor past the end of 
an input area, it will move to the beginning of the next 
input area if there is one. If not, the cursor will move 
to the beginning of the first input area in the box. 
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The left and right cursor movement keys on the key pad 
move the cursor left and right within an input area, 
again, moving to the next or first area as you attempt to 
move past the end of the area. The up and down 
arrows will move the cursor to the previous or next 
input area respectively. The tab key also moves the 
cursor to the next input area, while the tab key plus the 
upshift key moves the cursor to the previous input area. 

The INS and DEL keys can be used to insert and delete 
characters within an input area. Insert mode is 
indicated by the word INSERT on line 25. In insert 
mode, any characters moved out of the input area will 
be lost. Pressing INSERT again or any cursor control 
key will turn off insert mode. 

The BACKSPACE key will move the cursor to the left 
one space and delete that character. 

The Configurator Program will only accept the 
following characters as input for USERIDs, passwords 
and filenames: 

A - Z (The Configurator converts lowercase to 

uppercase for you.) 

0-9 

. and : (These characters are allowed only in 

filenames) 

No leading blanks are permitted in USERIDs, 
passwords and filenames. No imbedded blanks are 
permitted for any item. If you do enter an invalid 
character, the system will reject it. You can then 
correct the error and enter it again. 
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The Password Screen 

After reading in the Configuration file, or determining 
that it needs to build a new one, the Configurator 
presents you with a screen that prompts you for your 
password. This password is required to see or change 
the Configuration file. 

The Configuration file installed with VM/PC has the 
password "SYSTEM." 

To continue, type the password and press ENTER. 

If, for whatever reason, you choose not to continue, 
you can return to DOS by pressing function key 10 
(F10). Your Configuration file will not be changed. 



Function Menu Screen 

After typing the proper password, you will see the 
FUNCTION MENU screen, which is considered the 
main screen presented by the Configurator program. 
This screen, shown below, gives you a choice of six 
functions. To choose a function, press the function key 
for the function you wish to perform. 



Chapter 3. Configuring Your VM/PC System 3-7 





FUNCTION MENU 


Press the 


FUNCTION KEY for the activity you want. 




HELP INFORMATION 


F1 Update 


SYSTEM configuration. 




1 Make changes to the SYSTEM file 


F2 Update 


SYSTEM options. names, terminal or printer addresses, 




or spool file parameters. Add/change 


F3 Update 


USER configuration. autolog USERID. 


F^f Update 


configurator PASSWORD. 2 Add/Delete/Change SYSTEM OPTIONS such 




as 370 Processor Control Session. 


F5 Quit - 


do not update anything. 




3 Add/Delete/Change USERIDs, minidisks 


F6 End - 


save all updates. and links. 




k Change the Configurator Password. 




5 - 6 Exit from the Configurator. 



Figure 3-1. Function Menu 



Quitting the Configurator 

The Configurator program does not actually update the 
Configuration file until you have made all your changes 
AND then told it specifically to do so. This means that 
you can decide you want to quit at any time without 
applying the changes you have entered. If you do 
decide that you don't want to keep the changes you 
have entered, simply select the "Quit" function from 
the menu. You will then exit the Configurator and the 
Configuration file will remain unchanged. This includes 
any password changes you may have made. 
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Normal Exit from the Configurator 

The "End" function is the normal exit from the 
Configurator. This function causes all the changes you 
have made since starting the Configurator to be stored 
on the Configuration file. First, the Configurator 
performs any required file allocations for minidisks, 
giving you a chance to approve or cancel each 
allocation. After that, the Configurator writes the file 
and returns control to DOS, which will present its usual 
prompt. 



Update System Configuration Screen 

You use the Update System Configuration screen to 
define parameters that apply to all the users of the 
VM/PC system. Parameters that may differ for each 
user are defined on the User Selection screen. 

To reach the System Configuration screen from the 
Function Menu screen, press Function Key 1 (Fl) to 
choose the * 'Update SYSTEM Configuration" function. 
After doing so, you see the UPDATE SYSTEM 
CONFIGURATION screen. 
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UPDATE SYSTEM CONFIGURATION 

Make all changes then Press ENTER. 
Use TAB KEY to position cursor. 



Drive For: 

1-SP00L DIRECTORY C 2-SP00L FILES C 
3-Maximum Number of SPOOL FILES 030 



HELP/FUNCTION KEYS 
F1 - Help Information. 
F3 - Return to FUNCTION MENU 
Without recording changes. 



File Names for: 

4-CP/370 Nucleus C:CP.1VM 5"CP I/O Services C:CP 10. 1 VM 

6-Page Dataset CrPAGE.IVM 7-CP Message C:CPMSG.1VM 

8-Environment C:CMS.1VM 9-PC/370 Personality C: IMLPU. 1VM 



File Names for Host 3101 Session 

10 Terminal Value Specification Program C:SETUP.EXE 

11 Terminal Emulation Program C :TERMI NAL. EXE 

12 File Conversion Program C:F I LECONV. EXE 



13 Printer Device Address 00E 
]k Terminal Device Address 01F 



15 Autolog ID if any (Optional) 



Figure 3-2. Update System Configuration Menu 

The top part of the input area box deals with the system 
spool files, that is, printer files created by the users of 
the VM/PC Local 3270 Session. Printer file spooling 
creates a DOS file for each print file and a directory file 
that points to them. The directory and the spool files 
may or may not be on the same disk drive. The drive 
letter (A, B, C, or D), tells VM/PC which drive to use 
for these files. 

Note: Drive letters beyond D may be used if you have 
defined minidisks on Personal Computer DOS VDISKs 
on an AT/370. See "Using AT/370 RAM with 
VM/PC" on page C-4 for examples of minidisks on 
DOS VDISKS. 

You may also specify the maximum number of spool 
files the system will handle (from 1 to 999). 
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The next part of the input area box deals with the 
names of the six files used by VM/PC. All six of these 
files reside on your fixed disks (drive C or drive D), but 
they need not all be on the same drive. 

Note: See "Using AT/370 RAM with VM/PC" on 
page C-4 for an example of putting the Page Dataset 
file on a DOS VDISK on an AT/370. 

The files named are the PC XT/370 or AT/370 
hardware personality file, the file containing the error 
messages issued by VM/PC CP, and the program files 
that make up VM/PC, including the environment 
program (VM/PC CMS). 

You may move one or more of these files to your other 
fixed disk. If you do, you must tell VM/PC where to 
find them by changing the drive letter on the file 
specification displayed on this screen. Except for the 
Page Dataset, the drive letter for these six files must be 
C or D. For the Page Dataset, a file created by 
VM/PC, you may specify a drive letter of C, D or *. 
The * tells VM/PC to create the file on the fixed disk 
with the greater amount of available storage. 

Note: VM/PC allocates the Page Dataset when you 
start the local session and erases it when you logoff the 
local session, therefore this space will not be included in 
the response to a DOS CHKDSK command. 
Remember that if you have an AT/370 with expansion 
RAM, you may put the Page Dataset on a DOS VDISK. 
See the example in "Using AT/370 RAM with 
VM/PC" on page C-4. 

The third part of the input area box has the names of 
the files which contain the programs used by the Host 
3101 Session. These programs are supplied with the 
IBM 3101 Emulation program product. If you do not 
have these programs on your system, you may ignore 
this part of the input area box. 

The fourth part of the input area box specifies the 
terminal device (console) address and printer address 
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for your Local 3270 Session. You may change these if 
the environment you are running in your virtual 
machine requires printer and/or console addresses 
other than those supplied. 

The final part of the input area box is optional. If you 
supply a USERID here, it will automatically be logged 
on when the Local 3270 Session is initialized. If you 
specified an "Environment to Auto IPL" on the 
"Update Environment for User" screen, VM/PC will 
IPL that environment. 

Warning: Using the automatic logon option bypasses 
the password validation that normally occurs during the 
Local 3270 Session logon sequence. 

Press ENTER when you are finished making changes 
on this screen and want them recorded. If no syntax or 
other errors are found, you will go to the Function 
Menu screen. Press function key 3 (F3) instead of 
ENTER if you have made changes but decide you do 
not want them recorded. You will return to the 
Function Menu screen. 



System Options Screen 



You use this screen to choose whether VM/PC user(s) 
will have access to the 370 Processor Control Session. 

To reach the System Options screen from the Function 
Menu screen, press Function Key 2 (F2) to choose the 
"Update SYSTEM Options" function. You will see the 
System Options screen. 

The 370 Processor Control Session enables a skilled 
user to manipulate the internal registers, the memory, 
and the state of the 370 processor inside your system. 
This screen gives you a means of preventing users of 
the system from accidentally damaging their data by 
improperly using the 370 Processor Control Session. 



3-12 VM/PC User's Guide 



Type a Y for Yes or an N for No and press ENTER. 

The 370 Processor Control Session is described in the 
IBM Virtual Machine / Personal Computer Service Aids 
publication. 



Configurator Password Screen 

You use the Configurator Password screen to change 
the password that controls access to the Configurator 
program. If you change the password, it will take effect 
the next time the Configurator program is started. 

To reach the Configurator Password screen from the 
Function Menu screen, press function Key 4 (F4) to 
choose the "Update Configurator PASSWORD" 
function. You will see the Configurator Password 
screen. You may now change the password from the 
default of "SYSTEM" or its current value to whatever 
you like. 

Warning: If you change the password, you MUST 
NOT FORGET IT! If you do, you too will be unable to 
use the Configurator program in the future. If you do 
forget or lose the password, you will have to re-install 
the Configuration file supplied with VM/PC and, using 
the default password, rebuild the Configuration file to 
match your current needs. 

If you return a blank password, the old password will 
be retained. Also if you just press ENTER without 
changing anything, you will, of course, not change the 
password. Make the change if you wish, and press 
ENTER to return to the Function Menu. 
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User Selection Screen 

The User Selection screen is the first of a sequence of 
screens that are used to collect parameters that are 
different for each user of the system. 

To reach the User Selection screen from the Function 
Menu screen, press Function Key 3 (F3) to choose the 
"Update USER Configuration" function. You will see 
the User Selection screen. 

You use this screen to add or delete users from the 
system and to specify the parameters of the 370 virtual 
machine each user will experience. 

The User Selection screen contains a list of all the 
USERIDs currently listed in the Configuration file. If 
you are processing the Configuration file supplied with 
the VM/PC system, there will be two users listed. 
They are CMS and SAMPLE. Place the cursor next to 
the user you wish to modify/display/delete, or place 
the cursor on the top line next to "ADD new user" to 
add a user, then press ENTER. Notice that function 
key F3 will return you to the Function Menu. 

There are five screens used to collect parameters for an 
individual user. To explain the use of these screens, we 
will assume the use of the Configuration file supplied 
with VM/PC. The next five sections of this chapter will 
take you through each of the screens. 

User Function Selection Screen 

From the USER SELECTION screen let us select user 
CMS and press ENTER. This takes us to the USER 
FUNCTION SELECTION screen. If you had chosen 
to add a new user, this screen would have been 
bypassed, and you would have gone directly to the 
UPDATE ENVIRONMENT FOR USER screen, which 
we will discuss later. 
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There are 4 function keys active here to change users or 
return. F3 returns us to the Function menu as is always 
the case. F5 returns us to the USER SELECTION 
screen which was the previous screen. We will not 
discuss these two keys any further since they always 
perform the same function. This is the first screen that 
has Scroll keys. If you had more than 1 user listed on 
the previous screen, you would be able to scroll through 
the list using the F7 and F8 keys. Notice the name 
change on the top of this screen as you scroll. 

Update Environment for User Screen 

Select "User Environment" for user CMS by pressing 
Fl. You will see the environment items, for the user 
CMS, listed on the screen. Press the scroll keys and 
watch all of the environment items change as you scroll 
through the list of users. If you select "ADD new user" 
and then try to scroll through the user list, you will 
never come back to the screen with the blank input 
areas, because that entry is not yet considered a user. 
You must go back to the USER SELECTION screen 
and again select to add a new user. 

The "USERID" is the name given to identify the 
VM/PC user. It is required in order to logon and use 
the system. It may contain from 1 to 8 characters. You 
may wish to establish a convention such as using the 
last name of users as their USERIDs. To delete a user 
from the configuration file just blank out the 
"USERID" field on this screen. 

The "Password" is a character string that provides 
access authority to logon to the given USERID and 
access the associated data. This is a secret word which 
should only be known by the user and by the Technical 
Coordinator. 

The "Virtual Machine Storage Size" specifies the 
amount of storage the user will have simulated in his 
virtual machine when he logs on to VM/PC. The 
amount of storage is measured in kilobytes (K). For 
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example, 1 K of storage is 1024 bytes, and 1024 K is 
one megabyte. The value entered for virtual machine 
storage size can range from K to 4096 K (8192 K for 
an AT/370), and must be a multiple of 4K. 

Note: The user environments you define (USERIDs, 
passwords, etc.) need not agree with similar items you 
may be using on other systems running CMS. This is 
true even if you intend to use the VM/PC host services. 

The "Environment to Auto IPL" field is the name of 
the System/370 program to be loaded in the user's 
virtual machine upon logon. The environment name 
can only be "CMS" (unless your installation has 
installed another environment). Press ENTER to 
record the changes, and return to the USER 
FUNCTION SELECTION screen. Press F5 if you 
want none of the changes recorded before returning. 

If you select the user CMS, you will see that CMS is 
also the password for that USERID. The CMS 
USERID is the owner of the CMS System Library 
minidisk (known as the "System disk"), and is used to 
maintain the files or datasets used in common by the 
other CMS users on the VM/PC system. The CMS 
virtual machine storage size is 512K. 



Minidisk List Screen 



Now look at the user named SAMPLE. Select "User 
Minidisks" from the USER FUNCTION SELECTION 
screen by pressing F2. A minidisk is the simulation of a 
disk drive by using a portion of a real drive. The 
minidisk appears, to the program running in the virtual 
machine, like a real disk drive. However, it will usually 
be smaller than the actual disk drive being used. You 
should now see the MINIDISK LIST for the user 
selected. Notice that you can still use the scroll keys to 
move between the users currently in the list. 

You can now select one of the users' minidisks for 
modification or deletion, or optionally add a new 
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minidisk. Let's select the 101 disk of the user 
SAMPLE. Make the selection and press ENTER. 
will now see the screen shown in Figure 3-3. 



You 



UPDATE 



M I N I D 



S K 



Make all changes then press ENTER. 
Use TAB KEY to position cursor. 



1 


Ml 


lidisk Address: 101 




2 


Dr 


ve ID: C 




3 


S i ze of Mi n i d i sk 




(Num 


of 512 Byte Block 


s):1024 


k 


Mode Read(R) 1 Read/Wr i 


te(W) :W 


5 


Read-Share Password: 


ABC123 


6 


Wr 


te-Share Password: 


X0Y0Z 





FUNCTION KEYS 


F3 - 


- Return to FUNCTION MENU. 


F5 " 


- RETURN TO MINIDISK LIST. 


F7 - 


- Scrol 1 BACK 1 Minidisk. 


F8 - 


- Scroll FORWARD 1 Min 



FOR 



USER 



=>SAMPLE 



HELP INFORMATION 

Use this screen to define a disk 
(minidisk) for this user. 

1 The MINIDISK ADDRESS is the 
address by which the minidisk is 
known to the virtual machine. Enter 
a blank address to DELETE minidisk. 

2 The DRIVE ID is a letter identifying 
the drive the minidisk resides on. 

3 The NUMBER OF BLOCKS represents how 
many 512 byte blocks are to be 
allocated to the minidisk. 

5-6 The SHARE PASSWORDS allow other 
users knowing the password to 
access this user's minidisk in 
READ only or READ/WRITE mode. 



Figure 3-3. Update Minidisk for User Menu 

Note that, for this screen, the scroll keys will now scroll 
through the minidisk list, not the user list. 

The "Minidisk Address" is the address of that 
simulated disk as seen by this virtual machine. It is in 
the form of CUU (channel and unit address) as are all 
input/output device addresses in System/370. This 
field will be "101" since we selected the SAMPLE 101 
disk. To delete a minidisk simply blank out the 
"Minidisk Address" area and press ENTER. 
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The "Drive ID" is the drive letter of the drive where the 
actual minidisk data will be simulated and stored. 

The "Size of Minidisk" represents the size of the 
simulated disk. It is measured in the number of 
512-byte blocks allocated to the disk. The SAMPLE 
101 disk consists of 1024 physical blocks on the real 
drive C. That gives the SAMPLE 101 disk a storage 
capacity of 1024 X 512 = 512 K bytes or 1/2 
megabyte. The size of a minidisk can range from 1 to 
20688 (41376 on an AT/370) blocks. For the 
minimum size minidisk acceptable to CMS, refer to the 
CMS FORMAT command description in Chapter 
7, "VM/PC Commands" on page 7-1. 

The "Mode" letter can be either R (read) or W 
(read/ write). If the disk is read only, the disk can not 
be modified, that is to say the virtual machine can not 
write on the disk. Obviously it would have to be 
read/ write at some point in time to create it in the first 
place, but it can be changed to read only after it is built. 
A minidisk can also be copied (using DOS) from one 
disk drive to another. This permits you to move a 
minidisk from one VM/PC machine to another via 
diskette(s). 

The DOS file name associated with a minidisk can be 
determined as follows. The drive letter is specified on 
UPDATE MINIDISK screen. The file name is the user 
ID of the owner of the minidisk, and the file extension 
is the minidisk address. For example, the CMS 100 
disk as supplied with the VM/PC system will be named 
C:CMS.100. 

Note: The CMS. 100 disk for VM/PC Version 1 . 1 is 
2300 blocks. If you reuse your configuration file 
(CONFIG. 1VM) from VM/PC Version 1, you must 
change the size of the 100 disk for the user CMS to 
2300. 

The Read-share and Write-share passwords are 
optional. They permit links to be performed to the 
minidisk without having the links defined in the 



3-18 VM/PC User's Guide 



Configuration File. Such links are performed using the 
LINK and ACCESS commands. See "LINK" on 
page 7-35 and "ACCESS" on page 7-84 for further 
information. 

The links defined in the Configuration file (using the 
UPDATE LINK screen of the Configurator) do not 
require Read-share or Write-share passwords and take 
effect automatically upon logon to the Local 3270 
Session. 

If these passwords are defined for a minidisk, other 
users of the system who know the passwords may link 
to and access the data on the minidisk. If you want to 
let users of the system link to a minidisk to read its 
files, you must define a Read-share password for the 
minidisk. If a Read-share password is not defined, the 
minidisk will only be readable by its owner and by users 
with links to the minidisk defined in the Configuration 
file. 

If you want to let users of the system link to a minidisk 
to add, delete, or change files, you must define BOTH a 
Read-share and a Write-share password for the 
minidisk. If these two passwords are not both defined, 
the only users able to write to the minidisk will be its 
owner and those with read/write links to the minidisk 
defined in the Configuration file. 

If you wish to allow others to access your minidisk 
without having to know the password, use the password 
of "ALL." 

If you scroll through all the minidisks owned by the 
user CMS, you will notice that CMS has a very large 
100 disk. This is the CMS system disk, which is shared 
among all the CMS users as we will see later. 

Press the ENTER key to record the changes, if any, and 
return to the MINIDISK LIST screen. If you are 
finished with the minidisks for this user and wish to 
select another user's minidisks, use the scroll keys, or 
go back two screens to the USER SELECTION screen 
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by pressing function key F5 twice, and select another 
user. 

It should be pointed out that even though the minidisk 
is defined to the system and it is allocated on- a disk 
drive, it will not be usable by CMS until it is formatted 
by CMS using the FORMAT command. See 
"FORMAT" on page 7-116. Remember, when you 
format a disk, you are also erasing all the data on that 
disk. In the case of the CMS disk format, you will be 
erasing the files on the minidisk, not all the files on the 
real physical drive. 



Link List Screen 



Select user SAMPLE, and from the USER FUNCTION 

SELECTION screen select "User Links" by pressing 
F4. You should now see the LINK LIST screen. This 
screen is similar to the MINIDISK LIST screen. 
However, here we see a list of the Links for the selected 
user. You can select one of the existing Links for 
modification/viewing, or deletion, or select the option 
to add a new link. 

To continue with our example, make sure the cursor is 
in the "ADD a new LINK" position and press ENTER. 



Update Link Screen 



You are now looking at the UPDATE LINK screen. 
This screen is used to build links to other users' 
minidisks. 

Suppose another user of your system has a minidisk 
that contains information that the owner of the 
USERID SAMPLE routinely needs to access. Let's 
say that this other user is defined to the system with the 
USERID of TOM, and that the minidisk that SAMPLE 
needs is known to TOM's virtual machine as address 
"101." 
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You can build a link for SAMPLE to TOM's 101 
minidisk, so that both USERIDs can access the same 
minidisk by doing the following: 

1. In the "USERID (owner)" field, type the USERID 
that owns the minidisk. In our example, the owner 
is "TOM." 

2. In the "Owner's Virtual Address" field, type the 
address of the minidisk as it is known to its owner. 
In our example, this is "101." 

3. In the "Minidisk Address" field, type the address of 
the minidisk as seen by SAMPLE. Since SAMPLE 
already has a 101 minidisk, you must define the link 
with some other address, such as "201." 

4. In the last field, "Link Mode," type either an "R" 
for read only or "W" for read/write. If SAMPLE 
only needs to look at the information on TOM's 
minidisk, and should not be allowed to modify it, 
the mode should be "R." If SAMPLE needs to 
modify the information, the mode should be "W." 
For our example, type "R." 

In this link example, you have given the user SAMPLE 
read-only access to the user TOM's 101 minidisk, and 
the minidisk is known to SAMPLE'S virtual machine as 
201. 

Since you will not want to save the example 
information, press function key 5 (F5) to return to the 
LINK LIST screen. Then move the cursor to the 
"CMS 100" link and press ENTER. You will then see 
the UPDATE LINK screen that defines the link giving 
the user SAMPLE read/only access to the 100 minidisk 
owned by user CMS. This minidisk is also known to 
the SAMPLE virtual machine as 100. The user 
SAMPLE will not be able to write on his 100 disk since 
it is read/only. This is the CMS System disk, which 
contains the CMS commands, programs, macro 
libraries, etc. ALL CMS USERS SHOULD HAVE 
THIS LINK. If you go back and look at the minidisks 
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owned by SAMPLE, you will see that SAMPLE has a 
read/ write 101 disk and a read/ write 102 disk. The 
101 disk is his private storage disk, typically accessed 
mode "A" by CMS and commonly called the "A Disk." 
The access mode of his 102 disk is not automatically 
assigned. 



Disk Allocation and Checking 

When the END function is selected, (Function 6 on the 
FUNCTION MENU), the Configurator will test for the 
existence of all of the required system files. These file 
names were supplied on the SYSTEM 
CONFIGURATION screen. You will see a message if 
a required system file cannot be found. 

Next the Configurator will look at all the changes and 
additions to the minidisks. If the minidisk does not 
exist on the designated PC disk drive, it will be 
allocated. If the minidisk has been enlarged, the 
minidisk file will be enlarged to match the specification. 

Remember that CMS will not take advantage of the 
additional space until the CMS FORMAT command 
with the RECOMP option is used to recompute the 
minidisk size. If FORMAT is used without the 
RECOMP option, the new minidisk size will be 
computed, but all of the data previously on the minidisk 
will be lost. 

If the size of the minidisk is reduced, the Configurator 
will warn you, but will not decrease the size of the 
allocated space. When the size of a minidisk is reduced, 
you run the risk of losing data. 

Warning: When the USERID that owns the minidisk 
next uses the Local 3270 Session, the minidisk will be 
reduced automatically by VM/PC CP. 

The Configurator will not take that risk. 
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For the same reason, the Configurator will not erase a 
minidisk file when it is deleted from the Configuration 
file. If you really want to erase the minidisk, you must 
use the DOS ERASE command to erase the file. 

Before any action is taken, you will be asked to confirm 
the change. You may have added a minidisk to a user, 
and may plan to copy the file from a diskette created by 
another VM/PC system. Under this condition you do 
not want the Configurator to allocate the space. Here 
you should respond with a N (No) to the allocation 
message. A better way to install the minidisk, in this 
example, would be to copy the minidisk file to the drive 
before doing the configuration. This way the 
Configurator can check the size of the minidisk against 
the size you specified and extend it if necessary. 

If you wish to remove a minidisk and assign it to 
another user, you must use DOS to rename the file 
according to the rules for minidisk file names specified 
above. You must then use the Configurator to add the 
minidisk to the USERID of the new owner. 



Limitations 



The Configurator program holds the configuration data 
in arrays of fixed dimension, thus imposing limitations 
on the amount of data it will handle. The Configurator 
is limited to handling 20 users, each of which can have 
a total of 26 Links and/or Minidisks. 

The Configurator Program uses about 50,000 bytes of 
C disk storage for temporary workspace. This storage 
is freed upon exiting the Configurator Program. The 
filename used for the workspace is CONFIG.UT1. If 
such a file already exists on your system, the 
Configurator will ask for permission to erase it before 
returning to DOS. If you don't want to erase it, the 
Configurator will return to DOS and you will then have 
to rename or remove your existing CONFIG. UT1 file 



Chapter 3. Configuring Your VM/PC System 3-23 



(using DOS commands) before you can run the 
Configurator. 
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Chapter 4. Getting Started 



Invoking VM/PC 



VM/PC runs on your Personal Computer XT/370 or 
AT/370 as a DOS application. The required files were 
copied when you installed VM/PC according to the 
instructions in Chapter 2, "Installing VM/PC" on 
page 2-1. You start VM/PC by entering the command 
VMPC in either of these ways: 

• If you want to start VM/PC every time you start 
DOS, you can enter the command by using the 
automatic program execution procedure described 
in the Disk Operating System manual. 

• If you want to start VM/PC via keyboard entry, 
you can enter the command and press the ENTER 
key in response to the DOS prompt ( C > ). For 
example: 

C > VMPC 

After you enter the VMPC command, you see an 
introduction screen which contains the product name 
and the IBM copyright statement. 

Notes: 

1. If you have an XT/ 3 70 with hardware installed that 
enables you to emulate either a 3277-2 or a 
3278/3279, issuing the command VMPC gets you 
3278/3279 emulation. In this case, if you want 
3277-2 emulation, issue the command 

VMPC II 
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2. See "What To Do if Something Goes Wrong" on 
page 4-36 for a list of error messages you might 
receive after you enter the VMPC command. 
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Keyboard Usage 



If you have been using an IBM 3270 Display, you will 
notice that the keyboard on your IBM Personal 
Computer is not the same as the keyboard on your IBM 
3270 Display. 

The keyboards on the Personal Computer XT/370 and 
the Personal Computer AT/370 are similar but there 
are some important differences. 

The following sections show you the physical layout of 
the Personal Computer XT/370 and AT/370 
keyboards. The key tops which are shaded have their 
functions changed when the VM/PC application is 
running, that is, after the VMPC command is entered. 

The depiction and explanation of the XT/370 keyboard 
for 3277 emulation is shown first, followed by the 
XT/370 keyboard for 3278/79 emulation. Skip to the 
depiction and explanation of the AT/370 keyboard 
which follows these if you have an AT/ 3 70. 
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XT/370 3277 Keyboard Figure 



ERASE EOF 
(lowercase) 



Key 


Description 


Esc 


'CLEAR' will erase all data on the display. 


<- 


'NL' will move the cursor to the first unprotected field on the 
next line. 


Scroll 
Lock 


'SELECT' will cause the Session Selection Menu to be dis- 
played. If you press the 'Ctrl' key with this key while viewing 
the Session Selection Menu, it causes a break and a return to 
DOS. 


«— " 


'ENTER' causes the data you have typed to be passed to the 
computer. 


7 
Home 


'ERASE INPUT' will erase all the input data on your screen. 
It will not be passed to the computer. The 'Ctrl' key must 
also be pressed to use this function. 'Home' returns the 
cursor to the commandline. 


+ 


'TEST REQ'. When used with the shift key, it is a +. 


PrtSc 

* 


'RESET' will clear the Inhibit and Insert mode. 


1 
End 


'ERASE EOF' will erase all data to the end of the current 
field. 


F1-F10 

F1-F2 

F1-F3 


'PFl' thru 'PF10' when used alone. 

'PFH' and 'PFl 2' when used with the shift key. 

'PA1' thru 'PA3' when used with the 'Alt' key (PA3 is Host 

only). 


A, 

6 


The uppercase on this key (*) is recognized by VM/PC as a 
Logical Not character. 


i 
7 


The uppercase on this key ( ] ) is recognized by VM/PC as a 
solid vertical bar. 


\ 


The lowercase on the key s ) is recognized by VM/PC as a 
Cents sign. 



Figure 4-2. Description of XT/370 Keys for 3277 Emulation 
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XT/370 3277 Keyboard Figure 



ERASE EOF 

(lowercase) 



Key 


Description 


Esc 


'CLEAR' will erase all data on the display. 


<- 


'NL' will move the cursor to the first unprotected field on the 
next line. 


Scroll 
Lock 


'SELECT' will cause the Session Selection Menu to be dis- 
played. If you press the 'Ctrl' key with this key while viewing 
the Session Selection Menu, it causes a break and a return to 
DOS. 


— 


'ENTER' causes the data you have typed to be passed to the 
computer. 


7 
Home 


'ERASE INPUT' will erase all the input data on your screen. 
It will not be passed to the computer. The 'Ctrl' key must 
also be pressed to use this function. 'Home' returns the 
cursor to the commandline. 


4 


The lowercase on this key (< — ), when used with the Ctrl 
key, makes left cursor movement faster. 


6 


The lowercase on this key ( — ►), when used with the Ctrl 
key, makes right cursor movement faster. 


+ 


'SYS REQ'. When used with the shift key, it is a +. 


_ 


'DUP'. When used with the shift key, it is a - (minus sign). 


PrtSc 
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'RESET' will clear the Inhibit and Insert mode. 



Figure 4-4 (Part 1 of 2). 



Description of XT/370 Keys for 3278/79 
Emulation 
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Key 


Description 


1 
End 


'ERASE EOF' will erase all data to the end of the current 
field. 


Fl-FlO 

F1-F2 

F1-F3 

F4 
F5 
F6 

F7 
F8 
F9 
FIO 


'PF1' thru 'PF10' when used alone. 

'PFll' and 'PF12' when used with the shift key. 

'PA1' thru 'PA3' when used with the 'Alt' key (PA3 is Host 

only). 

'Field Mark' when used with the 'Alt' key. (Host only) 

'Cursor Sel' when used with the 'Alt' key. (Host only) 

'Attn' when used with the 'Alt' key. (Host only) 

'Print' when used with the 'Alt' key. (Host only) 

'Dev Cncl' when used with the 'Alt' key. (Host only) 

'IDENT' when used with the 'Alt' key. (Host only) 

'TEST' when used with the 'Alt' key. (Host only) 


6 


The uppercase on this key ( A ) is recognized by VM/PC as a 
Logical Not character. 


} 
] 


The lowercase on this key (]) is recognized by VM/PC as a 
solid vertical bar. 


{ 

[ 


The lowercase on this key ([) is recognized by VM/PC as a 
Cents sign. 



Figure 4-4 (Part 2 of 2). 



Description of XT/370 Keys for 3278/79 
Emulation 
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Key 


Description 


Esc 


'CLEAR' will erase all data on the display. 


- 


'NL' will move the cursor to the first unprotected field on the 
next line. 


Sys 
Req 


'SELECT' will cause the Session Selection Menu to be dis- 
played. 


Scroll 
Lock 


If you press the 'Ctrl' key with this key while viewing the 
Session Selection Menu, it causes a break and a return to 
DOS. 


Enter 


'ENTER' causes the data you have typed to be passed to the 
computer. 


7 
Home 


'ERASE INPUT' will erase all the input data on your screen. 
It will not be passed to the computer. The 'Ctrl' key must 
also be pressed to use this function. 'Home' returns the 
cursor to the commandline. 


4 


The lowercase on this key (< — ), when used with the Ctrl 
key, makes left cursor movement faster. 


6 


The lowercase on this key ( — ►), when used with the Ctrl 
key, makes right cursor movement faster. 


+ 


'SYS REQ'. When used with the shift key, it is a + . 


- 


'DUP'. When used with the shift key, it is a - (minus sign). 



Figure 4-6 (Part 1 of 2). Description of AT/370 Keys 
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Key 


Description 


PrtSc 

* 


'RESET' will clear the Inhibit and Insert mode. 


1 
End 


'ERASE EOF' will erase all data to the end of the current 
field. 


Fl-FlO 

F1-F2 

F1-F3 

F4 
F5 
F6 

F7 
F8 
F9 
FIO 


'PF1' thru 'PF10' when used alone. 

'PFH' and 'PF12' when used with the shift key. 

'PA1' thru 'PA3' when used with the 'Alt' key (PA3 is Host 

only). 

'Field Mark' when used with the 'Alt' key. (Host only) 

'Cursor Sel' when used with the 'Alt' key. (Host only) 

'Attn' when used with the 'Alt' key. (Host only) 

'Print' when used with the 'Alt' key. (Host only) 

'Dev Cncl' when used with the 'Alt' key. (Host only) 

'IDENT' when used with the 'Alt' key. (Host only) 

'TEST' when used with the 'Alt' key. (Host only) 


6 


The uppercase on this key (*) is recognized by VM/PC as a 
Logical Not character. 


1 
] 


The lowercase on this key (]) is recognized by VM/PC as a 
solid vertical bar. 


I 
[ 


The lowercase on this key ([) is recognized by VM/PC as a 
Cents sign. 



Figure 4-6 (Part 2 of 2). Description of AT/370 Keys 
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Session Selection 



The Copyright screen instructs you to press the 
ENTER key to continue. You then see a Session 
Selection Menu which looks like this: 







VM/PC 
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Menu 
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number of the 


session that 


you want 
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1-Break for immediate 


exit 


to DOS. 
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3 Host 


3101 Session 
















k 370 P 


rocessor Contro 


1 














LAl 


CN 




1 2 


3 4 




M 


SESSION 


SELECTION 



Figure 4-7. VM/PC Session Selection Menu 
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Notes: 

1. The 32 70 in the Host and Local session will be 
replaced by either 3277, 3278, or 3279 depending on 
the hardware you have. Chapter 1 explains which 
hardware produces which type of emulation. We will 
use the term 32 70 throughout this book although the 
number you actually see will be 3277, 3278, or 3279. 

2. Selections 1, 3, and 4 may not appear on your Session 
Selection Menu. See the following descriptions of 
these selections for information on when they will not 
appear. 

3. The numbers associated with particular sessions may 
change if you do not have all sessions available. 

A 'session' is a connection you establish with a 
computer. Once a connection is established, you can 
give the computer instructions to do whatever work you 
want it to do. VM/PC allows you to use your Personal 
Computer XT/370 or AT/370 by itself, or connected 
to a larger computer located somewhere else. These 
connections are referred to as 'local sessions' and 'host 
sessions', respectively. 

VM/PC will allow you to have a local session and two 
host sessions (3270 and 3101) at the same time. Since 
you only have one display and one keyboard, you can 
only look at anddtalk to one computer at a time. This 
session is called the 'active' session. 

The Session Selection Menu allows you to choose your 
active session. You see a list of the available sessions, 
each associated with a number. You select the active 
session by pressing the number assigned to that session. 

You use the Session Selection Menu any time VM/PC 
is running to change the active session. Whenever you 
change sessions, the sessions which are not active are 
not lost. You will be notified on the 25th line whenever 
a session which is established, but not active, changes. 
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The Session Selection Menu is displayed whenever the 
SELECT key is pressed. 

The sessions you may choose are: 



Local 3270 Session 



The Local 3270 Session allows you to activate the 370 
environment within your Personal Computer XT/370 
or AT/370. For details see "Logon Sequence" on 
page 4-21. 



Host 3270 Session 



The Host 3270 Session allows you to connect your 
Personal Computer XT/370 or AT/370 to a host 
computer using the 3270 Coaxial Connection. With this 
session active, you can communicate with any host 
computer which supports 3277 model 2 or 3278 model 
2 data streams. The types of systems to which you may 
connect include VM, CICS, TSO, MVS, etc. Your 
Personal Computer XT/370 will appear as a 3277-2, 
3278-2, or 3279-S2A terminal to that system. Your 
Personal Computer AT/370 will appear as a 3278-2 or 
3279-S2A to that system. You cannot connect an 
AT/370 as a 3277-2. 

Notes: 

1. The Host 3270 Session appears on the Session 
Selection Menu only if: 

a. an operational 3277-2 or 3278/79 Emulation 
Adapter is installed in your IBM Personal 
Computer XT/ 3 70, or 

b. an operational 32 78/79 Emulation Adapter is 
installed in your IBM Personal Computer 
AT / 370. 
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2. If an adapter is installed and the Host 3270 Session 
does not appear on your Session Selection Menu, turn 
off your IBM Personal Computer, then turn it on 
again and restart VM/PC. If the problem persists, 
call your technical coordinator or run the diagnostics 
described in the diagnostic testing section of the IBM 
Personal Computer XT/ 3 70 Guide to Operations, or 
the IBM Personal Computer AT/ 3 70 Guide to 
Operations. 

If you select this session, VM/PC displays the Host 
3270 Session screen, where you will see your normal 
host system logo. Logon and processing procedures are 
the same as your current procedures. The keyboard will 
be configured the same as the Local 3270 Session. 

If you happen to be running a long running host 
application and wish to do work on your VM/PC 
system at the same time, all you have to do is press the 
SELECT key and the VM/PC Session Selection Menu 
will be displayed again. You can then select the Local 
3270 Session if you wish, and logon to and IPL your 
local VM/PC (you could have also done this before 
starting your Host 3270 Session). You can now work 
on your local session at the same time that you are 
doing work on your host session. We refer to these as 
concurrent sessions. 

If the host computer is a VM system with the 
VMPCSERV program installed, you can combine the 
Local and Host sessions as described in Chapter 
6, "Host Services" on page 6-1. 



Host 3101 Session 



You can use the Host 3101 Session to communicate 
with other computers over an RS232 interface without 
leaving the VM/PC environment. 
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This is possible because this session allows you to run 
the IBM 3101 Emulation Program (6024042), which 
provides four main functions: 

• It allows you to use your Personal Computer 
XT/370 or AT/370 as if it were an IBM 3101 
Display Terminal. This is called "3101 emulation." 

• It allows you to adapt the specifications of your 
emulated 3101 to match what the host computer 
(the computer at the other end of the 
communications line) expects to find. This is done 
using a separate DOS file to contain the 
specifications for each type of connection you wish 
to make. Files containing specifications for seven 
popular connections are provided with the IBM 
3101 Emulation Program. 

• It transmits ASCII format files between your 
Personal Computer DOS environment and the host 
computer. 

• To complement the file transfer capability, it 
provides a file conversion utility that will convert a 
binary format file to ASCII format or an ASCII 
format file to binary format. 

The Host 3101 Session provides an alternate way of 
communicating with computers that can or cannot be 
accessed with the Host 3270 Session facilities. 

If you intend to use the Host 3101 Session, you should 
read the documentation supplied with the IBM 3101 
Emulation Program. 

Note: This selection appears on the Session Selection 
Menu only if an Asynchronous Communication 
Adapter is installed on your IBM Personal Computer 
XT/370 or AT/370. 



4- 1 6 VM/PC User's Guide 



Prerequisites 

To use the Host 3101 Session, you need to have the 
Asynchronous Communications Adapter installed in 
your Personal Computer XT/370 or AT/370. You 
also need to install the IBM 3101 Emulation Program, 
which is not supplied with VM/PC. 

Note: The names of the programs supplied with the 
IBM 3101 Emulation Program are used by VM/PC to 
call those programs when the Host 3101 Session is 
active. If you ever change the names of the IBM 3101 
Emulation Program programs, you MUST update the 
VM/PC Configuration File to reflect all name changes. 
If you fail to do so, VM/PC will be unable to find the 
programs. 

Using the Host 3101 Session 

The Host 3101 Session presents you with the following 
menu screen: 





IBM 3101 EMULATION PROGRAM SELECTION MENU 


Press 


the number of the program that you want: _ then, press ENTER. 




1 Terminal Value Specification Program 




2 Terminal Emulation Program 




3 File Conversion Program 


LAl 


CN 12^ M 3 HOST 3101 SESSION 



Figure 4-8. 3101 Emulation Program Selection Menu 

The Terminal Value Specification Program is used to 
select, modify or create a specification file for use by 
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the Terminal Emulation Program. Press the "1" key to 
run the Terminal Value Specification Program. 
VM/PC will then load this program (using the default 
DOS file name of C.SETUP.EXE) and give it control 
of the Host 3101 Session. 

The Terminal Emulation Program is used to actually 
communicate with another computer over the RS232 
communications interface. Press the "2" key to run the 
Terminal Emulation Program. VM/PC will then load 
this program (using the default DOS file name of 
C:TERMINAL.EXE) and give it control of the Host 
3101 Session. 

The File Conversion Program is used to convert ASCII 
format files to or from binary format files. The files 
involved in the conversion must be regular DOS files, 
but they can be on the fixed disk(s) or on diskette(s). 
Press the "3" key to run the File Conversion Program. 
VM/PC will then load this program (using the default 
DOS file name of C:FILECONV.EXE) and give it 
control of the Host 3101 Session. 

Once any of the three programs begins to run, its 
operation is as described in the IBM 3101 Emulation 
Program documentation. 

When using the Host 3101 Session, the keys on your 
keyboard behave as the IBM 3101 Emulation Program 
expects to find them. The one exception to this is the 
SELECT key, which remains your means of switching 
to other VM/PC sessions. 

You may use the IBM 3101 Emulation Program key 
definition menu to re-define the keys on your keyboard, 
but DO NOT re-define the SELECT key. Your key 
re-definitions will not affect the other VM/PC 
sessions. 

It is possible to use the Host 3101 Session and all the 
other VM/PC sessions concurrently. This means that 
you may change active sessions and then return to the 
Host 3101 Session right where you left it. Also, if you 
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have begun an activity on another session (for example, 
a compilation on the Local 3270 Session), you can 
change to the Host 3101 Session while the activity you 
started continues to execute. You should not, however, 
attempt to start a file transfer from the Host 3101 
Session while the Host 3270 Session is also 
sending/receiving a file (using VM/PC Host Services). 
In that event, some loss of data may occur in the Host 
3101 Session, making it necessary to restart the file 
transfer. This restriction is due to the timing 
dependencies inherent in asynchronous 
communications. 

Since the IBM 3101 Emulation Program makes use of 
line 25 of your display screen, the indicators normally 
seen on that line while using other VM/PC sessions are 
not available when using the Host 3101 Session. 
However, the 25th line of the 3101 Emulation Program 
Selection Menu uses the same indicators as the Local 
3270 Session (only the session number and title, Host 
3101 Session, are different.) VM/PC 25th line 
indicators are described in 'The 25th Line" on 
page 4-28. 

For related reasons, when you change your active 
session from the Host 3101 Session to another session, 
any program you have started in the Host 3101 Session 
(unlike other VM/PC sessions) is forced by VM/PC to 
wait until you return to the Host 3101 Session. As a 
result, once you begin an activity (for example, a file 
transfer) using the Host 3101 Session, you should not 
change your active session until the activity completes. 

The Host Services facilities described in Chapter 

6, "Host Services" on page 6-1 are not available with 

the Host 3101 Session. 
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370 Processor Control 

The 370 Processor Control Session is intended to be 
used by a system programmer to debug 370 programs. 
This session will appear on your Session Selection 
Menu only if it was specified during the configuration 
process described in Chapter 3, "Configuring Your 
VM/PC System" on page 3-1. For details on the use 
of this session refer to the Virtual Machine / Personal 
Computer Service Aids publication. 
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Logon Sequence 



If you select the local session, you see the VM/PC 
Logon Screen which looks like this: 
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Figure 4-9. VM/PC Logon Screen 



You must now identify yourself to the local session. 
This process is called 'logon'. During the VM/PC 
configuration process, described in Chapter 
3, "Configuring Your VM/PC System" on page 3- 
you or your technical coordinator specified special 



1, 
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identification words to allow you, and only you, access 
to certain data. These words are called USERID and 
PASSWORD. The USERID can be any word 1 to 8 
characters long, your name for instance. The 
PASSWORD can also be any 1 to 8 character word. 
These identification words work as a pair, that is, every 
USERID has a unique PASSWORD associated with it. 
You must give the computer both of these words to 
complete the logon process. 

NOTE: You or your technical coordinator may have 
specified during the configuration process that you 
want to use the Autolog ID option and you do not want 
to use USERIDs and PASSWORDS. If this is the case 
you will not see the logon screen and should ignore this 
section. 

The logon screen has a flashing cursor after the word 
Userid:. Type your USERID there. 

After you type the USERID the cursor moves to the 
next line after the word Password:. (Press the NL or 
Tab key to move the cursor if your USERID is fewer 
than 8 characters.) Type your PASSWORD there. 
Your password is secret so whatever you type will not 
be displayed. Don't be alarmed. 

When you have typed both your USERID and your 
PASSWORD, press the ENTER key. If you have 
entered your USERID and PASSWORD correctly and 
have not changed the Environment: CMS field, the 
computer will do some processing and display the word 
Ready; which indicates the local session is active and 
you may skip the remainder of this section. 

If you did not type a USERID, or the one you entered 
cannot be found by the computer, the alarm will sound 
and an error message will be displayed. The message 
tells you the USERID you entered is not valid and 
positions the cursor for you to enter it correctly. 

If you did not type a PASSWORD, or the PASSWORD 
you typed is not correct for your USERID, the alarm 
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will sound and a message will be displayed. The 
message tells you that a PASSWORD is required or the 
one you entered is not valid and positions the cursor for 
you to enter it or correct it. 

The third line on the Logon Screen is Environment: 
CMS. If you press the ENTER key without changing 
the word CMS, the CMS environment will be started 
automatically. CMS stands for Conversational Monitor 
System. VM/PC CMS is part of the VM/PC system. 
It provides a variety of tools to help you do your job. If 
you should change the word CMS to anything else, the 
computer will search its files to find the environment 
you selected. Do not change the word CMS unless you 
are told to do so. 

If you should change the word CMS, the computer may 
give you a message that the environment you selected 
does not exist. If you see such a message type ipl cms 
and press the ENTER key. The computer will do some 
processing and display the word Ready; which indicates 
the CMS environment has been started and you may 
continue. 

If you delete the word CMS so the Environment: field 
is blank, VM/PC will log you on to VM/PC CP. You 
can then issue any CP command, for example IPL, 
there. 

NOTE: If you have not run the Configuration program, 
you may logon to VM/PC and run the Local 3270 
Session. A default logon configuration was provided for 
you during the installation process. This configuration 
has a USERID of 'SAMPLE' and a PASSWORD of 
'SAMPLE'. It provides you with an A-disk and access 
to the system files. The first time you use this logon, 
you will receive an error message 'Disk' A (101)' has 
invalid directory format'. Don't be alarmed. Enter the 
command FORMAT 101 A (N and reply YES to the 
'Do you wish to continue?' question. You'll also be 
asked to give a name as a label for the disk. 
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Note: Don't issue the FORMAT command unless you 
receive the message. 
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Screen Format 



The IBM Personal Computer Display has 25 lines of 80 
characters each. Once you have established a Local 
3270 Session or a Host 3270 Session, the first 24 lines 
will look like a 3270 display screen. (The end of the 
24th line in a Local Session is used for screen scrolling, 
explained below.) See "3278-2 and 3279-S2A 
Emulation in VM/PC" on page 4-34 for details on 
those emulations. 

The 23rd and 24th lines are where you enter commands 
that tell the computer what you want it to do. This is 
called the input area. The kinds of commands you may 
use in a Local Session are described in Chapters 5 thru 
7. The 23rd and 24th lines look like this: 



STATUS Scroll: 



The end of the 24th line displays status notices in both 
sessions and is used for screen scrolling in Local 3270 
sessions. 

Note: You can enter commands in both the input area 
and the scroll area. When you press ENTER, both 
commands will be executed. 
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Screen Scroll in a Local Session 

The Screen Scroll facility allows you to look at data 
which was on your screen but cannot be seen anymore. 
All transactions to and from the terminal (write output 
and read input) are saved in a terminal history buffer. 
As this information is scrolled off the display by the 
CLEAR key, PA2 key, or the Diagnose 58 erase 
option, it is not lost but placed in the terminal history 
buffer. 

The history buffer may be viewed any time the Local 
3270 Session is active. The screen scroll commands are 
entered in the Scroll: area at the end of the 24th line. 
The screen scroll commands are: 

• F[nn] - scrolls the history view so that more recent 
information is displayed (forward in time). The 
option nn, indicates the number of lines to be 
scrolled into the bottom of the screen (the bottom 
of the screen contains the most recent history item 
within the view). If nn is not specified, a full screen 
is scrolled forward (the item on the bottom of the 
window is moved to the top). 

• B[nn] - scrolls the history view so that less recent 
information is displayed (backward in time). The 
option nn, indicates the number of lines to be 
scrolled into the top of the screen (the top of the 
screen contains the least recent history item within 
the view). If nn is not specified, a full screen is 
scrolled backward (the item on top of the window is 
moved to the bottom). 

• TOP - moves the window to the least recent items 
in the history buffer. 

• BOT - restores the window to the display of the 
current activity. 

• R[nn] - scrolls the history viewing window to the 
right so that information lines longer than the 
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display size can be displayed (this option is enabled 
only if TERM WRAP OFF is active). 

• L[nn] - scrolls the history viewing window to the 
left (this option is enabled only if TERM WRAP 
OFF is active). 

The Screen Scroll facility can be used to look at data 
which has been cleared from the screen. It can also be 
used with the RETRIEVE facility of the CP SET 
command to retrieve commands from the history buffer 
and move them to the input area. Commands can then 
be executed by pressing the ENTER key or modified 
before execution. See "SET" on page 7-50 for more 
information. 



Status Notices 



To the left of the Scroll: area, VM/PC displays various 
STATUS notices. They tell you what is happening in 
the computer at the present time. For the Local 
Session, these notices are: 

• CP Read - This notice appears if you logon and do 
not automatically start up the CMS environment or 
if you press the PA1 key. It means a part of 
VM/PC called the Control Program is waiting for 
you to enter any CP command described in "CP 
Commands and Options" on page 7-12, such as the 
ipl cms command. 

• Waiting - This notice means a part of VM/PC 
called CMS is waiting for you to enter any 
command described in Chapter 7, "VM/PC 
Commands" on page 7-1. The computer is idle 
whenever this notice is displayed. 

• VM Read - This notice means some part of the 
system is waiting for you to enter some data. It will 
usually be preceded by a message asking for the 
data. 
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Running - This notice means the computer is 
working on something and you should not enter any 
commands. 

More... - This notice means that VM/PC has more 
information than can fit on one screen. After 20 
seconds the alarm is sounded and after another 10 
seconds, VM/PC displays the next screen. 

To see the next screen right away, press the 
CLEAR or the PA2 key. To hold this information 
on the screen, press the ENTER key. This changes 
the More... notice to Holding. 

Holding - This notice appears when the screen 
displayed a More... notice and you pressed the 
ENTER key. The screen will remain the same until 
you press the CLEAR or PA2 key. 

Pressing the ENTER key changes the Holding 
notice to More.... 

Not Accepted - This notice appears if you enter a 
command when the screen displayed More... or a 
Holding notice. The command you entered is not 
accepted by the computer. Not Accepted will 
remain on the screen for about three seconds. 

If you press the CLEAR key, the command you 
entered is ignored and must be entered again. If you 
press the PA2 key, your command will remain in 
the input area after the screen is cleared. 



The 25 th Line 



The 25th line gives you information on the status of 
other sessions, the state of certain keyboard functions, 
the state of your session connection, and a reminder of 
the name and number of the active session. 
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The 25th line indicators are based on those used by the 
3278 and 3279 Display terminals. Although the 25th 
lines for all sessions and menus are very similar, there 
are differences which are detailed below. 

Common 25th Line Indicators 

The 25th line uses 80 positions to pass information. 
Position 1 is on the far left of your screen and position 
80 on the far right. Although there are some indicators 
used in only one or two sessions or menus, most are 
common to all. 

This is a depiction of how the common indicators 
appear on the twenty-fifth line: 



. .1 + 2 + 3 + k + 5 + 6 + . 

X CN 1 2 3 4 M 1 NAME 



Here are further descriptions of these common 
indicators (Position number on 25th line followed by 
meaning) : 

• 9 - An X is displayed here when you have lost 
contact with the computer associated with the 
active session. The X displays for short periods of 
time whenever you press ENTER. Don't be 
alarmed. If the X displays for a long period and no 
activity appears to be taking place, there may be a 
problem with the computer. See "What To Do if 
Something Goes Wrong" on page 4-36. 

• 18 - A Caret ( A ) indicates you pressed the Ins key 
to enter Insert Mode. All data is entered at the 
cursor position and all data to the right is moved to 
the right. Press the RESET key (or any key that 
causes communication with the host or local 
sessions - ENTER, PA keys, PF keys, etc.) to turn 
off the Insert indicator. 
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Note: Using XEDIT in 3277 emulation you do not 
have to set nulls on before you can insert characters 
into a line. Using XEDIT in 3278 and 3279 
Emulation you must set nulls on before you can 
insert characters. Press PA2 (Alt and F2) before 
you press the Ins key to set nulls on for that line. To 
set nulls on for your entire file, issue the XEDIT 
command NULLS ON. Issue NULLS OFF to turn 
nulls off. 

• 19 - An up arrow (f) indicates uppercase shift; a C 
indicates uppercase lock. 

The up arrow displays when you press the SHIFT 
key. It indicates the uppercase of all keys you press 
will be entered. The up arrow turns off when you 
release the SHIFT key. 

The C displays when you press the CAPS LOCK 
key. It means all alpha characters you press are 
entered as uppercase. Press Caps Lock again to turn 
off the C. 

If you press SHIFT while the C is on, the keys will 
reverse states, that is, all alpha keys will be entered 
as lower case and all other keys will be entered as 
uppercase, and the C will turn off. 

• 20 - An N is displayed to indicate you have pressed 
the Num Lock key and the numeric keypad is 
active. Press Num Lock again to turn off Numeric 
Lock. 

• 34 - A 1 is displayed to indicate activity in session 
1. This and the 2, 3, 4, and M indicators following 
are turned off when you view the session or menu 
indicated. 

• 36 - A 2 is displayed to indicate activity in session 
2. 

• 38 - A 3 is displayed to indicate activity in session 
3. 
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• 40 - A 4 is displayed to indicate activity in session 
4. 

• 54 - An M is displayed to indicate activity on 
Session Selection Menu. 

• 56 - Host Services Activity Indicator. (Not in 3277 
Emulation.) May be: 

— a blank ( ) indicates Host Services not 
connected. 

— a dash (-) indicates Host Services is connected. 

— an up arrow (f) indicates activity using the Host 
Services. 

— when information is being passed through the 
Host Services, you will see the dash and the up 
arrow change back and forth. 

• 58 - Number of the Active Session 

• 60-80 - Name of the Active Session or Menu 

The 3278/3279 Local and Host Sessions and the 
Session Selection Menu have some further indicators 
described in the following section. 

Unique 25th Line Indicators 

All sessions and menus display the indicators listed 
above. The Local and Host 3278/3279 Sessions and 
the Session Selection Menu have these unique 
indicators: 

• Local 3278/3279 Session (position on 25th line 
and meaning) 

— 1 - An L is always on. 

— 2 - An A is always on. 

— 3 - An ■ indicates connection to the Local 
VM/PC. 

— 1 1-14 - Several indicators may be here. They 
are: 
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— [] - Inhibit indicator means keyboard is 
locked. Usually on when X indicator is on. 

— "*Q*" - Indicates you tried to enter data in 
a protected field. The keyboard is locked; 
press RESET to unlock it. 

f - You requested unavailable function. 

— QX - Operator is unauthorized. 

— Q> - Indicates you inserted too much 
data in a field. The keyboard is locked; 
press RESET to unlock it. 

— QNum - Indicates you inserted non-numeric 
characters in a numeric-only field. The 
keyboard is locked; press RESET to unlock 
it. 

Host 3278/3279 Session (position on 25th line and 
meaning) 

— 1 - Indicator can be either: 

4- indicates your 3274 Control Unit is ready. 

6 indicates your 3276 Control Unit is ready. 

I indicates your Display Printer Adapter is ready. 

i indicates your Workstation Adapter is ready. 

— 2 - Indicator can be either: 

A indicates the Control Unit is online. 

B indicates the Control Unit is online (SNA protocol). 

— 3 - Indicator can be any of: 

V indicates connection to application. 

■ indicates connection to Control Program. 

? indicates connection to host but not to program. 

— 1 1-17 - Indicators can be any of: 

— [] - Terminal Wait, time required at Host. 

— ? - Last operation not accepted. 

— SYSTEM - System Lock, Host has locked 
keyboard. 

— ~+ k Q+»- You tried to enter data in a 
protected field. 

— (j)> - You inserted too much data in a field. 
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— (j)Num - You inserted characters in a 
numeric field. 

— 9#? - You entered wrong printer ID. 
f - You requested unavailable function. 

— QX - Operator is unauthorized. 

— o< Q - Operator message not accepted. 

— Onn - Machine Check, Host 3278/9 
Emulator failing. 

— Onnn - Machine Check, Host 3278/9 
Emulator failing. 

X-i-nn - Communication problem between 

Control Unit and Host. 
X-i-nnn - Communication problem between 

Control Unit and Host. 

— PROGnn - Program Check, Data from Host 
has error. 

— PROG4nn - Program Check, Data from 
Host has error. 

— 0-0[] - Printer attached to 3274 Control 
Unit is busy. 

— 0-0[][] - Printer attached to 3274 is very 
busy. 

— O-0 - Printer attached to 3274 not working. 
S - Symbol you typed not recognized by 

Control Unit. 

— 02%% - Machine Check, feature mismatch 
between Control Unit and XT/370 or 
AT/370. 

21-27 - indicator can be either: 

x-i-nn indicates communications link error 

x-i-nnn indicates communications link error 

28-32 - indicators can be any of: 

— O-O indicates you pressed the IDENT 

key (Alt and F9) and are being asked to 
give a new printer ID number. 

— O-Onn indicates you're authorized to use 
printer number nn. 

— O- ED nn indicates printer number nn is 
printing your work. 

— O-jflnn indicates printer nn attached to your 
display station is out of order (power 
failure, mechanical problem, needs paper, 
etc.). 
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— O-O?? indicates the printer assignment has 
changed. You press the IDENT key (Alt 
and F9) to get the new printer assignment. 

Session Selection Menu (position on 25th line and 
meaning) 

— 1 - An L is always on. 

— 2 - An A is always on. 

— 3 - An ■ indicates connection to the Local 

VM/PC. 



3278-2 and 3279-S2A Emulation in VM/PC 

If your Personal Computer XT/370 or AT/370 has 
3278 Device Emulation hardware, VM/PC will be 
displayed as an emulated 3278-2 if you have a 
Monochrome adapter or an emulated 3279-S2A if you 
have a Color/ Graphics adapter. 

Note: The VM/PC support of 3279-S2A emulation 
will be the same as base color support of a 3279-S2A. 

3278-2 Emulation 

VM/PC emulation of a 3278 Model 2 does not include 
the following 3278-2 features: 

1 . Selector Light Pen 

2. Cursor Image Control 

3. Keyboard Clicker Control 

4. Monocase Switch 

5. Test Mode 

6. Magnetic Slot Reader 

7. Magnetic Hand Scanner 

8. Security Keylock 

9. Extended Highlighting 

10. Programmed Symbols 

11. APL/Text 

12. 3279 Problem Determination Features 

13. Audible Alarm Volume Control 
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14. Switch Control Unit 

15. Write Structured Field Command 

16. IBM 3270 Personal Computer Attachment 

17. Keyboards other than Typewriter 

18. Support for PF keys 13-24 

3279-S2A Color Emulation 

VM/PC emulation of a 3279 Model S2A does not 
support any of the 3278-2 features listed above and it 
also doesn't support: 

1 . Extended Color 

2. Base Color Control 

3. Color Convergence Adjustments 

4. 3287 Model 1C and 2C printer emulation 

Note: The XEDIT SET COLOR command accepts 
any valid attributes whether or not the device can use 
the attribute. The attribute is set, but there is no change 
in what is displayed. Even if a color monitor is being 
used, the attributes will be set but the basic default 
colors will still be used. The same thing is true for the 
SET CTLCHAR and SET RESERVED commands. 

Similarly, the EXTRACT COLOR, CTLCHAR, and 
RESERVED commands will return attributes as they 
are set, even though these attributes do not affect what 
the user sees. 
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What To Do if Something Goes Wrong 



System Failures 

System failures are errors detected in the Personal 
Computer XT/370 or AT/370 hardware or in the 
VM/PC software. They can be detected during the 
VM/PC startup or at any time during normal VM/PC 
processing. Whenever a system failure is detected, you 
will be notified in two ways. 

• The Session Selection Menu will be updated to 
indicate an error on the Local 3270 Session. The 
Session Selection Menu will instruct you to select 
the Local 3270 Session for more information. 
When you select the Local 3270 Session, you will 
see the message listed below. 

• When the Local 3270 Session is active, the 
following message will be shown: 



Local 3270 Session Terminated (or Initialization Failure) 
Press F1 for retry, SELECT to return to Session Menu 
XXXXXXXXXXXXXXXXXXXXXXXXX 



where XXXXXXXXXXXXXXXXXXXXXXXXX is an error 
message. 

If you receive this message, press the Fl key to 
attempt a retry. If the retry is successful, the local 
session will be restarted. Your last entries may be 
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lost and may be entered again. Any host sessions 
which were active will not be affected. 

If the retry is unsuccessful, you must take some 
further action. Refer to the procedures below or call 
your technical coordinator and tell him/her the 
error message you received. 



Startup Failures 



During the startup period (after you issue the VMPC 
command), VM/PC can detect and report the 
following types of failures: 

• STORAGE ERROR, See VM/PC User's Guide RC 
= 2670 

A storage error was detected, press the Fl key to 
attempt a retry. If the retry is successful, the 
problem may be intermittent. Record the numbered 
code (RC) for reference and continue processing. 

If the retry is unsuccessful, call your technical 
coordinator or run the diagnostics described in the 
'Diagnostic Testing' section of the IBM Personal 
Computer XT/ 3 70 Guide to Operations or IBM 
Personal Computer AT/ 370 Guide to Operations. 

. PROCESSING UNIT ERROR, See VM/PC User's 
Guide RC = 2680 

A processing unit error was detected, press the Fl 
key to attempt a retry. The recovery actions are the 
same as for the STORAGE ERROR described 
above. 

• HARDWARE ERROR, See VM/PC User's Guide 
RC = 2681 

An undetermined hardware error was detected, 
press the Fl key to attempt a retry. The recovery 
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actions are the same as for the STORAGE ERROR 
described above. 

'nnnnnnn' File Not Found, See VM/PC User's 
Guide RC = 2695 

A file that is necessary to complete the start up 
process could not be found, nnnnnnn is the file 
name. It must be reloaded from the distribution 
diskette. Notify your Technical Coordinator or 
refer to the procedures in Chapter 3, "Configuring 
Your VM/PC System" on page 3-1 if you have 
recently reconfigured your system). 

'nnnnnnn' File Bad, See VM/PC User's Guide RC 
= 2696 

A file that is necessary to complete the start up 
process could not be read, nnnnnnn is the file name. 
It must be reloaded from the distribution diskette. 
Notify your technical coordinator or refer to the 
procedures in Chapter 2, "Installing VM/PC" on 
page 2-1 (or Chapter 3, "Configuring Your 
VM/PC System" on page 3-1 if you have recently 
reconfigured your system). 

VMPC Configuration file not found 

The file "CONFIG. 1 VM," needed for VM/PC 
startup, was not found in your DOS directory. 
Reconfigure, that is, re-issue VMPCCON. 

Memory block extension failure 

Personal Computer DOS was unable to provide 
enough storage for VM/PC. Re-boot 
(Ctrl-Alt-Del) to recover storage and reissue the 
command. 

VMPC system too large for memory 
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You do not have enough storage to run VM/PC. 
Re-boot the system by pressing the Ctrl key, the 
Alt key, and the Del key at the same time. 

• Error reading VMPC configuration file 

An error occurred while reading the DOS file 
"CONFIG. 1VM". This file is needed for VM/PC 
startup. Try re-issuing the VMPC command. If 
this fails, reconfigure, that is, re-issue VMPCCON. 

• VMPC CP I/O Services file not found 

The file "CPIO.IVM", needed for VM/PC startup, 
was not found in your DOS directory. Reinstall 
"CPIO.IVM" from your installation diskettes, or 
reinstall all of VM/PC. 

• VMPC system load error, RC = $ 

An error occurred while the VM/PC system was 
being loaded. Check your configuration file for 
errors. If none are there, you will have to reinstall 
VM/PC. 

• VMPC configuration file format error 

VM/PC detected a format error in your 
configuration file. Return to DOS and issue the 
VMPCCON command to display your 
configuration file. 

• No space under 256K | 5 12K for CP I/O Services 

VM/PC could not find space in System Board 
RAM (256K on XT/370 or 512K on AT/370) to 
load CPIO Service. 

• Too many options specified 

No more than two options may follow the VMPC 
command. 
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Invalid VM/PC Option 

There are only two valid options which may follow 
the VMPC command: 

1. [/7] means that you want a 3277-2 terminal 
session. 

2. [/d] means that you want to set the memory 
dump trigger. Re-booting the system (that is, 
depressing the CTRL key, the ALT key, and the 
DELETE key at the same time) during a 
process will force a memory dump to diskette. 
See the Virtual Machine / Personal Computer 
Service Aids publication for details on this 
option. 

Duplicate parameters specified 

Following the VMPC command, you typed one of 
the valid options twice. 

3277-2 Session is not supported on AT/370 

You issued the VMPC /I command on an AT/370. 
You cannot run a 3277-2 terminal session on the 

AT/370. 



Processing Failures 



During processing, VM/PC can detect and report many 
types of hardware and software failures which prevent 
it from continuing. These messages and the 
recommended recovery actions are described in 
Chapter 8, "VM/PC Messages" on page 8-1 of this 
book. 
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System Error Conditions 

System error conditions are errors caused by external 
conditions which may or may not be detected by the 
Personal Computer XT/370, AT/370 or VM/PC. 
They can occur at any time during normal processing. 

Error Messages 

During processing on the Local 3270 Session, error 
messages may be displayed to you. Most of these 
messages will be easy to understand and you should be 
able to continue with no trouble. If any message does 
not make sense to you, refer to Chapter 8, ' 'VM/PC 
Messages" on page 8-1 for a description of what 
happened to cause the message. 

System Unavailable 

During processing on the Local or Host Sessions, the X 
indicator in position 9 on the 25th line is on whenever 
contact is lost with the computer with which you are in 
session. This indicator, System Unavailable, comes on 
whenever the ENTER key is pressed but should be 
turned off in 1 to 3 seconds. 

If the indicator remains on for an unusually long period 
of time you can assume something has gone wrong. (If 
INPUT INHIBITED is on, first try pressing RESET.) 
The action you should take depends on the type of 
session: 

• Host sessions usually indicate a problem at the host 
computer. Call your Technical Coordinator and 
determine if the host computer is operational. If the 
computer is operational, press the SELECT key. 

— If the screen does not change, the problem is in 
the Personal Computer hardware or VM/PC 
software. Call your technical coordinator or run 
the diagnostics described in the 'Diagnostic 
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Testing' section of the XT/370 or AT/370 
Guide to Operations. 

— If the Session Selection Menu appears, the 
problem is in the connection with the host 
computer. Call your Technical Coordinator and 
report the connection failure. 

Local sessions usually indicate a problem with the 
hardware or VM/PC software. Press the SELECT 
key. 

— If the screen does not change, the problem is in 
the Personal Computer hardware and the 
Personal Computer diagnostics should be 
executed to pinpoint the cause. 

— If the Session Selection Menu appears, the 
problem is in the 370 hardware and the 
Personal Computer diagnostics should be run to 
pinpoint the cause. 
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Chapter 5. Using VM/PC Commands to 
Do Work 



Using Commands to Do Work 

In this section, we'll tell you how to use commands to 
do your work and we'll give you examples of how to use 
them. We've grouped the commands under task 
headings. Here's a list of the task headings and an 
indication of who should read each section. 

1 . Creating, Changing and Managing Files - All 
VM/PC users should read this section. 

2. Printing Files - All VM/PC users should read this 
section. 

3. Writing EXEC s - All VM/PC users who will be 
writing EXECs to help them do their work should 
read this section. 

4. Setting Up Your System to Meet Your Needs - All 
VM/PC users should read this section. Those who 
plan to link their Local and Host sessions should 
read the examples of how to set up their system. 

5. Transferring Personal Computer DOS and VM/PC 
Files - Everyone who has Personal Computer DOS 
files that they would like to use with VM/PC or 
who would like to use the files they create in 
VM/PC on a Personal Computer DOS system 
should read this section. 
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Creating, Changing and Managing Files 



The VM/PC Editor, referred to by the command that 
calls it, XEDIT, provides a wide range of useful 
facilities to help you create, change, and manage your 
files. 

More information on the XEDIT commands discussed 
in this section can be found in the VM/SP System 
Product Editor User's Guide and the VM/SP System 
Product Editor Command and Macro Reference. 



Creating Files 



What Is a File? 



Information stored in the system is organized in 
collections or groups of data called files. You organize 
the information that you store in the system in your 
own personal file collection. You may choose to store a 
collection of short stories on the system by putting each 
story in its own file. Or a collection of memos to Mr. 
Smith may be stored in a file to keep them separate 
from the file containing memos to Mr. Jones. The 
system provides you with programs and information 
that will help you choose a way to organize your own 
personal file collection. 

You will need a way to identify each file so that later, 
when you want to use it again, you will be able to tell 
the system which information to give you. 

You can identify a VM/PC file by giving it its own 
name. The three parts of a file identifier are filename 
(fn), filetype (ft), and filemode (fm). 
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The filemode identifies the collection to which the file 
belongs, as well as giving it certain attributes. Most 
data files that you create will have a fm of Al. The 
"A" identifies the file as part of your personal file 
collection, and the "1" means that the file will be 
visible to other users with "read access" to your 
personal file collection. Al is assumed by the system if 
you do not specify fm when you issue file manipulation 
commands. Be sure that you understand the system 
action and purpose for filemode before you specify a 
mode other than Al. 

Filetype specifies the type of data contained in the file. 
VM/PC recognizes some specific filetypes that give the 
file contents special meaning. Files containing 
programs have a filetype that identifies the source 
language interpreter or compiler. For example, 
FORTRAN, COBOL, and ASSEMBLER language 
programs are stored in files with FORT, COBOL, and 
ASSEMBLE filetypes respectively. 

You can specify any filetype that you choose for files 
containing data. There are, however, certain programs 
that require their input data to be stored in files with a 
specific filetype. SCRIPT is an example of such a 
program — it requires data to be in a file with a filetype 
of SCRIPT. 

Finally, the filename is the least restrictive of the three 
elements. A filename may be up to eight numbers and 
letters, in any combination that you choose. You will 
find that filenames that help identify the file contents 
are the most useful. When used in combination with 
the 8-character filetype, the fn ft can readily identify a 
specific file or group of files according to content. 

In the examples that follow, files containing similar 
types of data have the same filetype. For example, you 
can name files containing monthly reports OCT84 
REPORT, NOV84 REPORT, DEC84 REPORT, etc. 
You can choose a filetype of CALENDAR for files 
containing daily calendar information. 1 12784 
CALENDAR, for example, might contain daily 
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calendar information for November 27, 1984. MEMO 
TOGHRIS would be a good name for a file containing a 
message for Chris until you find it necessary to 
distinguish one message to Chris from another. You 
will discover more uses for grouping f iletypes later, 
when you read about other file manipulation 
commands. 

When you type commands, be sure to type them as they 
are shown in this book, including spaces if there are 
any. If a space is missing or a word is misspelled, the 
system won't recognize the command. Commands can 
be typed in capital or lowercase letters, or a 
combination of the two. 

When we show you the format of a command, we will 
print everything that must be typed exactly as shown in 
capital letters. When you have to substitute your own 
information, we'll show the word in all lowercase 
letters. For example, a command format is: 

XED IT f i lename f i letype filemode 

If a word is shown in capital letters, it must be typed 
exactly as shown, although you can use capital or 
lowercase letters. Because the words filename, filetype, 
and filemode are shown in all lowercase letters, you 
would substitute your own three-part file label in their 
places. 

If command names can be abbreviated, we will show 
the minimum abbreviation in capital letters. For 
example, 

I nput 

You could enter the command as I, IN, INP, INPU, or 
INPUT. The capital letter (I) shows the minimum 
abbreviation. 
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Creating a File 

Use the XEDIT command to create a file. Its format is: 

XEDIT filename filetype filemode 

After you type the command, press the ENTER key. 

Note: On the XT/370, the ENTER key is the long key 

on the right side that has the bent arrow on it ( *•). 

On the AT/370, the ENTER key also has the word 
Enter on it. 

If you entered the command: 

xedi t test file al 

your screen would look like this: 



TEST FILE A1 F 80 Trunc=80 Size=0 Line=0 Column=1 Alt=0 
Creat i ng new file: 



* * *. Top of File""" 

I ... + ..'... 1.... + 2 + 3.... + h + ....S + 6 + . 

End of File 



X E D I T 1 File 
LAl 2 Local 3270 Session 
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Here's an explanation of the various information on the 
screen: 

1 File Identification Line 

The first line has the three-part file label - filename 
filetype filemode. F 80 means that the length of a 
line is fixed and the file will hold lines up to 80 
characters long. TRUNC means "truncation 
column." TRUNC =80 means that if you type 
more than 80 characters in a line, the additional 
characters are rejected by the system. SIZE=0 is 
the number of lines in the file. LINE=0 is the file 
line number of the current line, which is explained 
in number 7, below. Alt=0 is the alteration count, 
which is explained in "Protecting Files" on 
page 5-29. 

2 Message Line 

The editor communicates with you by displaying 
messages on the second line of the screen. These 
messages might tell you that you made an error in a 
command, or they might provide information. 

3 Large Arrow Command Line 

The large arrow (= = = = >) at lower left of the 
screen points to the XEDIT command line. One of 
the ways you communicate with the editor is by 
entering XEDIT commands on this line. XEDIT 
commands can be typed in either uppercase or 
lowercase, or a combination of both, and many can 
be abbreviated. 

After typing a command on this line, you must 
press the ENTER key to send the command to the 
editor. When the ENTER key is pressed, the 
command disappears from the command line and is 
"executed," or carried out. 

4 Status Area 

The lower right corner displays the current status 
of your editing session, for example, input mode. 
It also shows the number of files you are editing. 
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The status area in this screen shows that one file is 
being edited. 

Prefix Area 

The prefix area is the five equals signs (= = = ==) 
that appear to the left of each line in the file. You 
can perform various editing tasks on a line by 
entering "prefix commands" in the prefix area of 
that line. We'll discuss prefix commands later. 

File Area 

The rest of the screen is available to display the 
lines in the file. The file lines are inserted between 
the ***TOP OF FILE*** and ***END OF 
FILE*** notices you now see on the screen. 

Current Line 

The current line is the file line in the middle of the 
screen (above the scale). It appears brighter than 
the other file lines or is "highlighted." In this 
screen, the current line is the TOP OF FILE line. 

The current line is important because most 
commands you type in the command line perform 
their functions starting with the current line. 
Naturally, the line that is current will change as 
you move up and down in the file. Many XEDIT 
commands perform their functions starting with 
the current line, and change which line is current 
when they are finished. 

Scale 

The scale appears under the current line to assist 

you in editing. It's like the margin scale on a 

typewriter. 

VM/PC Information Line 
The last line on the screen is shown in "reverse 
video." VM/PC uses this line to provide 
information to you. See "The 25th Line" on 
page 4-28 for a description of the information 
provided on this line. 
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Entering Data 



One way to enter data in a file is to use input mode. 
The INPUT command puts you input mode. Its format 
is: 

I nput 

In input mode, the prefix areas (= = = ==) disappear. 
The message line and status area display the notice 
INPUT MODE. You type your data in the input zone. 
The input zone is the bottom half of the screen, 
between the scale and the command line. 

The command line contains the notice ***INPUT 
ZONE***. It contains this notice because you can't 
enter commands from the command line while using 
input mode. The notice marks the end of the input 
zone and reminds you that you cannot enter commands. 
You have to go back to edit mode to enter commands. 
We'll show you how later. 

The cursor is placed automatically on the first line in 
the input zone. This is where you should begin typing 
the data. After you've typed each line, press the 
new-line key to return the cursor to the beginning of 
the next line. You could use one of the other 
cursor-movement keys, but the new-line key is faster. 
(The new-line key is a key at the upper right of your 
keyboard; it looks like this, -« — ). 

The lines you typed move to the top half of the screen. 
The last line you typed is the new current line. After 
you pressed the ENTER key, the editor changed all the 
letters you typed to capitals. Later, you'll learn how to 
tell the editor not to change them to capitals. If you 
had more data to type, you could continue typing in the 
input zone (between the current line and the command 
line). 

If you have no more data to type, press the ENTER key 
again. This takes you out of input mode and back into 
edit mode. The screen returns to edit mode layout, and 



\i 
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the file contains the data. The file identification line 
changes to indicate the number of lines in the file and 
the number of the current line. 

You can enter input mode at any time to insert new 
lines of data in the file by using the INPUT command. 
Press the ENTER key twice to return to edit mode. 

When you're finished working with a file, you use the 
FILE command if you want to keep it. After you enter 
the FILE command, you'll see a ready message 
(Ready;) It tells you that this editing session is over, 
and VM/PC is ready to do more work for you. Notice 
that the cursor returns to the command line. That's 
where you'd type the command to create another file. 

Note: Remember to press the ENTER key after you 
type a command on the command line. That sends the 
command to VM/PC for processing. 

Capital and Lowercase Letters 

If you want the letters in your file to be entered in the 
file exactly as you typed them, use the SET CASE 
command. This tells the editor to use mixed case, that 
is, both capital and lowercase letters, when the data is 
entered in the file. Its format is: 

SET CASE Mixed 

If you fill up the input zone but want to continue typing 
data in input mode, press the ENTER key one time. 
The data moves up on the screen, and you can continue 
typing in the cleared input zone. When the input zone 
is filled up again, press the ENTER key once again, etc. 
You can stay in input mode and continue typing as long 
as you need to. When you're ready to return to edit 
mode, then press ENTER twice. 
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Splitting and Joining Lines 

To split or join lines, you can press a PF key instead of 
typing a command in the command line and then 
pressing the ENTER key. During an editing session, 
each PF key is set to an XEDIT command. You don't 
press the ENTER key when you use PF keys. The 
command is sent to the editor automatically when you 
press the PF key. 

Important Notes: 

1 . On your keyboard, the function keys are labelled 
Fl, F2, etc. On other keyboards, they're labelled 
PF1, PF2, etc. When we use the term PF key we 
mean the F keys on the left of your keyboard. 

2. In this book, we will be talking about PF keys 1 
through 12. Your terminal has 10 F keys. You get 
PF1 1 by pressing the shift key with Fl. You get 
PF12 by pressing the shift key with F2. We'll refer 
to them as PF1 1 and PF12, but remember that you 
must press two keys to get them on your keyboard. 

To split a line in two: 

• Move the cursor under the character where you 
want the line to be split. 

• Then press PF1 or PF1 1 . 

The cursor remains where it was before the line was 
split. 

You may want to split a line if you need to add 
information to a line. The cursor is in place, and you 
can continue typing on that line. 

To join two short lines: 
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Place the cursor in the first line where you want the 
second line to go. Note that anything to the right of 
the cursor will be deleted. 
Then press PF1 orPFll. 



Setting Tabs 

Sometimes you may want to place information in 
certain columns. The PF4 key acts like a tab key on a 
typewriter. Each time PF4 is pressed, the cursor moves 
to the next tab column. Initial tab settings are defined 
by the editor. You can change these tab settings using 
a SET TABS command. 

You can find out what the tab settings are with the 
QUERY TABS command. Its format is: 

Query TABS 

The tab settings are displayed on a cleared screen. 
Press the CLEAR key to get your file back on the 
screen. 

You can change these tab settings with the SET TABS 
command. Its format is: 

SET TABS n1 n2 n3 nk etc. 

You substitute the column numbers where you want the 
tabs set for nl, n2, and so forth. These settings remain 
in effect for this editing session only. The next time 
you edit this file, you must enter the SET TABS 
command. Otherwise, the initial tab settings will be in 
effect. 

Displaying PF Key Settings 

Use the QUERY PF command to find out what the PF 
keys are set to. Its format is: 

====> Query PF 
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The XEDIT commands assigned to all the PF keys are 
displayed, on a cleared screen. Press the CLEAR key 
to get your file back on the screen. 

Use the QUERY PF command with the PF key number 
to find out the setting for a particular PF key. Its 
format is: 

====> Query PF10 

The PF key setting is displayed in the message line. 

Inserting Words in a Line 

One way to insert letters, words, or spaces in a line is as 
follows: 

• Press the PA2 key (Alt plus F2). 

• Press the Ins key. 

• You enter insert mode, and you can type the 
characters to be inserted. VM/PC displays a caret 
( A ) in position 18 of your 25th line to indicate 
you're in Insert Mode. 

• Press the RESET key to type normally again. 

When characters are inserted in a line, the other letters 
move over to make room for them. 

Notes: 

1. Each time you need to insert characters in a different 
line, you must press PA2 and Ins in order to use insert 
mode. After you're finished inserting characters in 
that line, press RESET. You can use insert mode in 
both edit and input modes. 

2. If you want to ready the whole file for inserting 
characters, you can issue the XEDIT command 
NULLS ON. Then you need only press Ins and type 



5-12 VM/PC User's Guide 



characters when you want to insert. Issue NULLS 
OFF to turn off the insert capability. 

3. If you're emulating a 3277 Display Terminal, you 
need not press PA2 before Ins in order to use insert 
mode. However, it won't hurt anything if you press 
both. 



Power Typing 



Power typing is another kind of input mode. The 
advantage of using power typing is that you can type 
continuously, as if the screen were one long line. You 
do not have to be concerned with line length or word 
length. You can start typing a word on one line of the 
screen and finish it on the next. In fact, if you're a 
skilled typist, you don't even have to look at the screen. 
When you reach the end of a line, the cursor 
automatically moves to the beginning of the next line. 
It's like having an automatic carriage return on a 
typewriter. 

To enter power typing mode, enter the POWER 
command. Its format is: 

POWer 

If you want a sentence to begin on a new line, you must 
precede it with a pound/number sign (#). It will not 
appear in your file. It simply tells the editor to start 
that text on a new line. If you run out of space on the 
screen, press the ENTER key, and more typing room 
will be provided for you. When you want to stop power 
typing, press the ENTER key twice. 

You can use power typing mode at any time during an 
editing session by entering the POWER command. The 
data entered using power typing is inserted after the 
current line, as it is when you use the INPUT command. 
When you enter POWER, the current line of your file is 
displayed as the top line on the power typing screen, 
but you cannot type over it. 
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If you want to insert characters or spaces in a line while 
you're using power typing, press the PA2 then the Ins 
key. Remember to press the RESET key when you are 
finished using insert mode. 

Creating an XEDIT Profile 

You can use various SET commands to tailor an editing 
session to meet your needs. For example, if you want 
the cursor to tab to columns 10 and 20, you enter the 
command SET TABS 10 20. If you want an automatic 
SAVE command issued periodically, you use a SET 
AUTOSAVE command. If you want your data to 
appear in capital and lowercase letters, you enter SET 
CASE MIXED. 

You can put all these commands (and others) in a file 
named XEDIT PROFILE. Its filename must be 
PROFILE and its filetype must be XEDIT. To create 
this file, enter XEDIT PROFILE XEDIT. Type the 
commands you want, and enter a FILE command. 
Then, all the commands in the PROFILE XEDIT file 
will be executed automatically each time you enter an 
XEDIT command. This saves you the time it takes to 
type these commands each time you edit a file. 

A sample PROFILE XEDIT file might contain these 
commands. Each command must be typed on a 
separate line. 

SET CASE MIXED 

SET AUTOSAVE 20 

SET TABS 10 20 30 40 

SET PF12 FILE 

You should be familiar with all the commands except 
the last. You already know that when you edit a file, 
the PF keys have various functions. If you would 
rather have one or more PF keys set to different 
commands, you can do this in the PROFILE XEDIT 
file. The command has the format: 

SET PFn command 
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You substitute the number of the PF key for "n," and 
you substitute the command you want assigned to that 
PF key for "command." In our example, we have 
assigned the FILE command to PF12. After this file is 
put on disk, pressing PF12 would do the same thing as 
entering the FILE command. 



Changing Files 

This section discusses the commands that display a list 
of your files, add new lines, take out lines, duplicate, 
move, and copy lines, locate and change data in a file, 
combine files, and sort data in a file. 

Displaying a File on Your Screen 

To work on a copy of a file that is on your disk, use the 
XEDIT command: 

XEDIT filename filetype filemode 

If the filemode is a, you don't have to type it. 

A copy of the file appears on your screen, but the 
original is still on your disk. It remains unchanged until 
you enter a FILE or SAVE command. 



Adding Lines 



One way to add a line of information is by using the 
INPUT command. Another way is to use a prefix 
command that adds a blank line. It is called a prefix 
command because you type it in the prefix area, not on 
the large arrow command line. Once the blank line is 
added, you type the new data in that line. 

You type a prefix command over any of the five equal 
signs in the prefix area. You can use either capital or 
lowercase letters. Then press the ENTER key to carry 
out the command. 
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The prefix command that adds a blank line after the 
one in which it is entered is a. You can type a number 
before or after the a to add more than one line. The 
following are all valid ways to type this command: 

====A Adds one blank line after this line. 

a==== Adds one blank line after this line. 

10a== Adds ten blank lines after this line. 

===A5 Adds five blank lines after this line. 

There are several prefix commands. You'll learn some 
of them in this section. If you type a letter that is not 
one of these commands and press ENTER, the status 
area displays 

1 val ue ' pendi ng. . . 

where value is the name entered in the prefix area. To 
correct the error, you could press the ERASE EOF key 
to clear the prefix area. Then type the correct prefix 
command. 



Moving through a File 



As your files grow, sooner or later they won't fit on one 
screen. To look at each screen of the file, you use 
commands that "scroll" the file. Scrolling is like 
turning the pages of a book. 

Moving Forward or Backward: Two PF keys are set 
to commands that scroll the file. PF8 scrolls forward 
one screen. PF7 scrolls backward one screen. 

Moving to the Bottom or Top: Use the BOTTOM 

command to go forward to the end of the file. The 
BOTTOM command makes the last line of the file the 
new current line. To move the cursor to the large arrow 
command line from any place on the screen, just press the 
ENTER key. 

The TOP command makes the TOP OF FILE line the 
new current line. You might want to use this command 
when you need to add a line at the beginning of the file. 
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Moving Down or Up: Use the DOWN command to 
move the display one or more lines toward the end of a 
file and the UP command to move the display toward 
the top of the file. Their format is: 

Down n or Up n 

You substitute the number of lines you want to move 
down for "n." Both these commands change which line 
in the file is the current line on your screen. 

Another way to move up or down in a file is to use the 
/ (slash) prefix command. You can type a / in the 
prefix area of any line on the screen. When you press 
the ENTER key, that line becomes the new current 
line. Then, if you enter an INPUT command from the 
command line, the new lines you type in input mode 
will be inserted between the current line and the line 
that followed it. 

Note: When the current line is somewhere in the 
middle of your file and you enter an INPUT command, 
the part of your file that was displayed in the bottom 
half of the screen disappears temporarily. It is not gone 
from the file. After you type your data in the input 
zone and return to edit mode, that part of the file will 
appear, after the lines you typed. 

You enter a / in any position of the prefix area. For 
example: 

Deleting Lines 

The d prefix command deletes the line in which it is 
entered. (Do not confuse it with the Del key, which 
deletes characters and spaces within a line.) You type a 
letter "d" in any position of the prefix area of that line. 
You can type a number before or after the "d" to 
delete a number of lines. The following are all valid 
ways to type a d prefix command. 
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====d Deletes this line. 

d==== Deletes this line. 

10d== Deletes this line and the next nine lines. 

===D5 Deletes this line and the next four lines. 

Can you press the ERASE EOF key to clear a line? 
Yes, but there are two things you should be aware of. 
First, you must move the cursor to column one in the 
line and press the spacebar once before pressing the 
ERASE EOF key. If you don't press the spacebar, the 
data will come back in the line the next time you press 
the ENTER key. This prevents you from erasing a line 
if you press the ERASE EOF key accidentally. Second, 
the data will be removed from the line, but the blank 
line will remain in the file. So it's better to use a d 
prefix command if you want to delete a line. If you 
want to delete only some of the characters in a line, 
instead of a whole line, you can use the delete key. 

Deleting a Block of Lines: To delete a block of lines, 
type the letters "dd" in the first line of the block. Then 
type "dd" in the last line of the block. Then press the 
ENTER key. For example: 

dd=== This is the first line I want to delete. 

===== This is the second. 

===== This is the third. 

===== This is the fourth. 

dd=== This is the last. 

When you press the ENTER key, all of the lines are 
deleted. 

A block of lines doesn't have to be all on one screen. 
You can type "dd" on the first line of the block and 
then scroll the display until you find the last line of the 
block. Then you can type the second "dd" and press 
the ENTER key. Use PF8 to scroll forward, PF7 to 
scroll backward. 

If you type "dd" in a line and then press PF7 or PF8, 
the status area displays: 

'DD 1 pending 
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This reminds you that the editor is waiting for you to 
enter the second "dd," thus completing the block. 

Cancelling A Deletion - RECOVER Command: 

Suppose you use a d prefix command to delete one or 
more lines, and then you change your mind. You want 
the lines back. You can get them back by using the 
RECOVER command. It is entered in the large arrow 
command line and has the format: 

RECover n 

You substitute the number of lines you want to recover 
for "n". 

The recovered line(s) will appear immediately above 
the current line. You can put the lines back where they 
belong by using the m prefix command, discussed later. 



Duplicating Lines 



If you want to repeat a line in a file, you can use the " 
(double quotation mark) prefix command. If you want 
the line duplicated more than one time, type a number 
before or after the ". 



Copying Lines 



If you want to copy lines from one part of a file to 
another, you can use the c prefix command. 

To copy one line, type a letter c in the prefix area of the 
line you want to copy. Then you have to tell the editor 
where you want it to be copied. You do this by typing 
either an f (for "following") or a p (for "preceding") in 
the prefix area of another line. When you press 
ENTER, a copy of the line where you typed the "c" is 
placed: 

• Either after the line containing an "f" 

• Or before a line containing a "p." 
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For example: 

====c This is the line I want copied. 

====f I want it to be copied after this line. 

When the ENTER key is pressed, the file will look like 
this: 

===== This is the line I want copied. 



===== I want it to be copied after this line. 
===== This is the line I want copied. 

Copying More Than One Line: You can type a 
number before or after the "c" to copy more than one 
line. The following are all valid ways to type the c 
prefix command. 

====c Copies this line. 

=c5== Copies this line and the next four lines. 

10c== Copies this line and the next nine lines. 

You must indicate where the lines are to be copied with 
an f or p prefix command. 

Copying a Block of Lines: To copy a block (a group 
of consecutive lines), type the letters "cc" in the prefix 
area of the first line of the block. Type "cc" in the 
prefix area of the last line of the block. Then press the 
ENTER key. This way, you don't need to count the 
number of lines you want copied. For example: 

cc=== This is the first line I want to copy. 

===== This is the second. 

===== This is the third. 

===== This is the fourth. 

cc=== This is the last. 



p==== ! want them to be copied before this line. 

When the ENTER key is pressed, a copy of the block 
of lines will be placed before the line containing the 
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"p." (If the line contained an "f," the block would go 
after that line.) 

If the block of lines extends for more than one screen, 
you can type "cc" on the first line of the block and then 
scroll the file until you find the last line of the block. 
Then you can type the second "cc." You can also scroll 
the file before typing the "f" or "p." 

While you scroll the file, the status area displays: 
'CC 1 pending 

The editor is waiting for you to enter the second "cc" 
oran"f" (or "p"). 

Moving Lines 

Moving lines means to remove them from their original 
place and put them in another. 

The procedure for moving lines is the same as for 
copying lines, except you use an m prefix command 
(instead of a c prefix command). As with copying, you 
must show the destination line with an "f" or a "p." 
You can move more than one line by typing a number 
before or after the "m." 

You can move a block of lines the same way you would 
copy a block. Just type "mm" (instead of "cc") in the 
prefix area of both the first and last lines of the block. 
Indicate the destination by using "f" or "p." 

Cancelling a Prefix Command - RESET Command 

You know that scrolling the file while entering different 
parts of a prefix command causes the status area to 
display: 

'value' pending 

where value is the name entered in the prefix area. 



Chapter 5. Using VM/PC Commands to Do Work 5-21 



If you change your mind mid-stream, you can cancel 
the operation by entering this command (in the large 
arrow command line) : 

====> RESet 

If you have typed any prefix commands (even those 
that do not cause the notices above to be displayed) but 
have not yet pressed ENTER, you can press the 
CLEAR key to remove them from the prefix area. 

LOCATE and CHANGE Commands 

You use a LOCATE command to locate the line that 
contains the text you want to change. Its format is: 

Locate/your data 

Note: You must type a separator between the 
command name (LOCATE) and your data. In the 
example above, a slash (/) is the separator. If the data 
to be located contains a slash, like VM/PC or 
01/23/85, you must use a different special character as 
a separator. For example, LOCATE$VM/PC or 
LOCATE%01/23/85. The following special 
characters cannot be used as separators: -. (not), + 
(plus), - (minus), or . (period). 

The LOCATE command tells the editor to look through 
the file, starting with the line following the current line, 
until it finds "your data." 

You can change the located data using this CHANGE 
command: 

Change/ol dword/newword/ 

This form of the CHANGE command changes the first 
occurrence of the old word in the current line. This is 
why you used the LOCATE command. When the 
editor locates the data, it makes the line that contains it 
the new current line. 
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Changing a Word Throughout a File: To change data 
throughout a file, use this form of the CHANGE 
command: 

====> c/olddata/newdata/ " " 

The message x OCCURRENCE(S) CHANGED ON x 
LINE(S) tells you how many words were changed. The 
editor searched every line of the file, from the current 
line to the last, and changed "olddata" to "newdata." 
Note the format of this command. You must type a 
slash (/) after the new word (newdata), and you must 
type two asterisks with a space between them (* *). The 
first asterisk tells the editor to search every line of the 
file. The second tells it to change every occurrence of 
the old word in each line. 

After a CHANGE command, the last line searched 
becomes the new current line. 

Note: Remember that the change starts with the 
current line. If you enter this kind of command when 
the current line is someplace in the middle of a file, the 
change is made until the editor reaches the end of the 
file. It doesn't go back to the beginning to make 
changes there. 

Tips on Using LOCATE and CHANGE: The 

LOCATE and CHANGE commands both seem simple, 
but there are a few things you have to be careful of. 

It's not a good idea to use the CHANGE command 
followed by * * unless you're absolutely sure of what 
you're doing. When you put * * after the CHANGE 
command, the editor takes you at your word that you 
want it to search every line of the file, from the current 
line to the last line, to find the letters and make the 
change. 

It's important to include spaces both before and after 
the words you want to change. This reduces the number 
of wrong matches that might occur. 
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Backward Locate: A backward LOCATE works just 
like the LOCATE command, except the editor searches 
backward (toward the top of file) rather than forward 
(toward the end of file). You identify a backward 
LOCATE by typing a minus sign (-) before the slash 
(/). 

Locating Adjacent Words: The LOCATE command 
can be used to locate two or more adjacent words in a 
line. For example, you could enter LOCATE/ wordl 
word2/. 

Repeating a Command - The = (equal) Command 

After you have issued a command, you can use the PF9 
key, which is set to the = (equal) command, to 
automatically repeat the last command. It saves you 
from having to retype it. 

See also "Retrieving Commands" on page 5-59 for 
information on retrieving a command to the command 
line so you can modify it before issuing it again. 

Combining Files 

Inserting Data from Another File: To insert all or part 
of one file into another file, you can use the GET 
command. You could use the GET command to 
combine chapters in a book. Or if you had three 
separate files on tax deductions, charitable deductions, 
and medical deductions, you could use the GET 
command to make one comprehensive deductions file. 

Inserting a Whole File: To combine two files, filel 
work and file2 work, you would do this: 

1. Enter command "xedit filel work." 

Note: The GET command inserts another file after 
the current line in the file you are editing. 
Therefore, you must make current the line after 
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which you want the data inserted. We'll make the 
last line current by using the BOTTOM command. 

2. Enter command "bottom." 

3. Enter command "get file2 work." 

The message EOF REACHED means that a copy of 
the entire file has been inserted at the end of "filel 
work." The last line inserted is the new current line. 

You copy "file2 work" when you GET it. You do not 
remove it from storage. 

Inserting Part of a File: To insert part of a file after 
the current line, you indicate the line number of the first 
line and the number of lines you want to insert at the 
end of the GET command, like this: 

GET filename filetype first-line number-of- 1 i nes 

Cancelling Changes to a File 

You've made changes to a file, but you decide you don't 
want to keep the changes. How can you get rid of the 
changes and keep the file as it was originally? That's 
easy. Press PF3, which is set to the QUIT command. 
(You can also enter QUIT on the command line, but 
pressing PF3 is easier.) 

The following message is displayed: FILE HAS BEEN 
CHANGED. USE QQUIT TO QUIT ANYWAY. 

If the file has been changed (or is new), the editor gives 
you that warning message to see if you really want to 
quit (that is, not put this file on disk). 

If you QUIT when you really meant to enter a FILE 
command, you would then enter FILE. But if you 
intend to quit, enter QQUIT, as the message says, on 
the command line. You can enter an abbreviation, QQ. 
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When you get a copy of a file on your screen just to 
look at it, not to change it, it's better to QUIT instead 
of FILE when you're finished. The FILE command 
tells the editor to rewrite the changed file over the old 
file on disk. Because you haven't made any changes, 
you really don't need to have the editor rewrite the file. 
The QUIT command is faster because the editor 
doesn't have to rewrite the file. 

Numbering Lines of a File 

When you used the GET command to insert part of a 
file, you had to know the starting line number and the 
number of lines you wanted to insert. You use the SET 
NUMBER ON command to number the lines of the 
file. Its format is: 

SET NUMber ON 

The line numbers appear in the prefix area, replacing 
the five equal signs. Lines are numbered from the first 
line of the file, not from the first line on the screen. 

The line numbers aren't placed on disk when you enter 
FILE or QUIT. If you want line numbers the next time 
you edit the file, you'll have to enter the SET 
NUMBER ON command again. 

If you no longer need the line numbers, enter: 

SET NUMber OFF 

Sorting a File 

XEDIT Sort: Starting with the current line, the 
XEDIT SORT command arranges a specified number 
of lines according to sort fields. If each line of your file 
started with a name, this would be a field you might 
choose to sort by. You determine the starting and 
ending columns of the longest name and use them as a 
parameter on the sort command. 
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You enter the SORT command on the command line. 
Its format is: 

SORT number-of- 1 i nes columnl column2 

You substitute the number of lines you want sorted for 
"number-of-lines." You can substitute an asterisk (*) 
here when you want all lines, from the current line to 
the last, to be sorted, "columnl" is the first column in 
the sort field. "column2" is the last column. 

The SORT command begins with the current line, so 
you need to make the first line you want sorted the 
current line. 

If you're sorting numbers and want them in descending 
order, from highest to lowest, type a letter "d" in the 
SORT command, before the first column number. The 
"d" stands for "descending order." (If you don't type a 
"d," the file is sorted in ascending order.) 

For example, the command: 
====> sort * d 1 k 

would sort the numbers in columns 1 through 4, from 
the current line to the end of the file, in descending 
order. 

CMS SORT Command: The CMS SORT command 
allows you to sort information without requiring you to 
edit the file. 

If, for example, you want to sort the information in the 
file RADIO WAVES A by frequency and store the 
result in a file called RADIO FREQS A, type the 
following information on the CMS command-line: 

SORT RADIO WAVES A RADIO FREQS A 

The CMS SORT command will ask you to specify 
which columns bound the fields on which you want the 
file sorted. You can specify up to 253 pairs of 
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numbers, each pair designating the starting and ending 
columns of a data field to be used for sorting the file. 
SORT will use the leftmost pair of numbers as the 
major sort field. When the SORT is complete, you will 
have two files on your A-DISK: the original RADIO 
WAVES and a new file RADIO FREQS, with the same 
information as RADIO WAVES sorted in ascending 
sequence of the fields you specified. Here's the screen 
before sorting: 



RADIO WAVES A1 F 


80 Trunc=80 Size=12 Line=5 Column=l Alt=0 


===== * * * Top of File 


* * * 


===== WEST GERMANY 


9765 


===== VOICE OF AMERICA 


6125 


===== AUSTRALIA 


6035 


===== QUITO, ECUADOR 


9560 


===== NETHERLANDS 


9865 


I... + ....1 + ... 


.2 + 3 + k + ....5 + 6 + .. 


===== GREECE 


9615 


===== BBC 


9750 


===== HAVANA 


6165 


===== CANADA 


9655 


===== SPAIN 


6090 


===== PEKING 


9780 


===== MOSCOW 


9450 


===== * * * End of File 




====> 






X E D I T 1 File 


LA| 


2 Local 3270 Session 



Ready; 

sort radio waves a radio freqs a 
DMSSRT605R Enter sort fields: 

20 23 
Ready; 



Here's the screen after sorting: 
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RADIO FREQS A1 F 


80 Trunc=80 Size=12 L i ne=6 Column=1 Alt=0 


===== * * * Top of File 


X JU J- 


===== AUSTRALIA 


6035 


===== SPAIN 


6090 


===== VOICE OF AMERICA 


6125 


===== HAVANA 


6165 


===== MOSCOW 


9^50 


===== QUITO, ECUADOR 


9560 


| ... + .... 1 + . . . 


.2 + 3 + 4 + 5 + ....6.... + ., 


=-=== GREECE 


9615 


===== CANADA 


9655 


===== BBC 


9750 


===== WEST GERMANY 


9765 


===== PEKING 


9780 


===== NETHERLANDS 


9865 


===== * * * End f File 


* * A 


====> 






X E D 1 T 1 File 


LA I 


2 Local 3270 Session 



Protecting Files 



You can minimize the danger to a new file you're 
creating or the changes that you're making to an 
existing file from system or line failure by using either 
the SAVE command or the SET AUTOSAVE 
command, or both. The Alt= indicator tells how many 
lines you've changed since your last SAVE. 
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SAVE Command 

You can enter a SAVE command at any time while 
you're creating or revising a file. Its format is: 

SAVE 

After you press the ENTER key, the file you're 
working on is written on disk. However, it will stay on 
the screen. After you add lines or make more changes, 
you'll have to enter the SAVE command again to save 
those new lines or changes. 

If you've issued a SAVE command while working on a 
file, you still have to issue a FILE (or QUIT) command 
to end the editing session. If you have used a SAVE 
command while working on a file and then enter QUIT, 
the changes you made before you entered SAVE will be 
written on disk. But the changes you made after you 
entered SAVE will not be written on disk. 

SET AUTOSAVE Command 

If you don't want to bother entering SAVE periodically, 
you can use the SET AUTOSAVE command. You 
need to enter it only once during an editing session. 
This command issues a SAVE command automatically 
each time you've typed in or changed a certain number 
of lines. You decide what the number should be. 

If you want the file saved every time you change ten 
lines, your command is: 

====> set autosave 10 

The SET AUTOSAVE command can be entered at any 
time during an editing session. However, it's best to 
enter it at the beginning of an editing session, right 
after you call out the file. 

If you've entered a SET AUTOSAVE command and 
system operation stops while you're working on a file, 
your file won't be saved under its own file label. It will 
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have a new file label. Every time the automatic save 
occurs, you'll see the message AUTOSAVED AS n 
AUTOS AVE Al. The part of the message that reads 
"n AUTOSAVE Al" is the new label. The filename 
will be a number (like 1, 2, or 3) and the filetype will be 
AUTOSAVE. You would now have two files, one with 
the original label, and one with the AUTOSAVE label. 
However, the AUTOSAVE file is the more current one, 
so you want to replace the old file with it. 



Managing Files 

You use the editor to make changes to the contents of 
your files. But sometimes you may want to make other 
kinds of changes. For example, you may want to 
rename a file or even discard it. Or what do you do 
when you forget a file label and you want to edit that 
file? The commands discussed in this section make it 
easy for you to manage your files, no matter how many 
you have. 

More information on the commands discussed in this 
section can be found in the VM/SP CMS Command 
and Macro Reference and the VM/SP CP Command 
Reference for General Users. 

Getting a List of Your Files 

If you can't remember the exact name of a file you 
want to work with, you can use the FILELIST or 
LISTFILE commands. Both these commands display a 
list of the files you have on your disk. Use the 
FILELIST command if you want to do something 
(EDIT, ERASE, RENAME, etc.) to the files that are 
listed. Use the LISTFILE command if you only want 
information about the names of your files. 

Remember that every file has a three-part label: 
filename, filetype, and filemode. Generally, the files 
you create and change have a filemode of A. This 
means that they are all kept in a collection of files 
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called your A-disk. The FILELIST and LISTFILE 
commands display a list of all the files on your A-disk. 
(Later you'll see how to display a list of files on other 
disks, such as B-disk, C-disk, etc.) 

Using the FILELIST Command 

Here's a sample filelist: 



yourid FILELIST A1 


V 


106 Trunc=106 


Size=6 


Line= 


Column= 


Alt=0 


Cmd Fi lename 


Fi letype 


Fm 


Format 


Lrecl 


Records 


Blocks 


Date 


Time 


FILE1 


WORK 


A1 


F 


80 


7 




1 


1/23/85 


14 


48:20 


FILE2 


WORK 


A1 


F 


80 


9 




1 


1/23/85 


14 


45:02 


FILE3 


WORK 


A1 


F 


80 


22 




2 


1/23/85 


13 


27:28 


FILE4 


WORK 


A1 


F 


80 


8 




1 


1/23/85 


10 


50:59 


FILE5 


WORK 


A1 


F 


80 


4 




1 


1/23/85 


10 


45:19 


FILE6 


WORK 


A1 


F 


80 


12 




1 


1/23/85 


10 


35:00 


1= Sort(name) 


2= Refresh 


3= Quit 


4= Sort(type) 5= 


Sort(date) 6= 


5ort(size) 


7= Backward 


8= Forwa 


rd 


3= FL /n 


10= 




11 = 


= XEDIT 


2= 


Cursor 


















X E D I 


T 


1 File 


LAi 
















2 Local ; 


5270 Session 



The file list shows a lot of information about the files 
on the A-disk. 

1 The first line has information about the file list 
itself. Your userid appears instead of "yourid." 
The SIZE field shows how many files are in this 
list. Here, SIZE=6 means there are 6 files on this 
A-disk. The LINE field tells you which file in the 
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list is the first on this screen. Here, LINE=1. As 
you scroll through the list, the number will change. 

2 The next line has headings that show what 
information is listed about each file: 

Cmd 

is a space where you can type certain 
commands. We'll discuss this later. 

Filename 

is the filename of the file. 

Filetype 

is the filetype of the file. 

Fm 

is the filemode of the file. You can ignore the 
number that appears after the filemode letter, 
for example, Al. 

Format Lrecl Records Blocks 

are fields that contain information about the 
file format and are not important to you now. 

Date and Time 

is the last time you changed this file. If the 
file was never changed, this is the date you 
created it. 

3 The PF keys are set to various useful functions, 
which are shown at the bottom of the screen. 
They are different from the PF key settings when 
you are editing a file. For now, note that when 
you are finished using the list, press PF3 to "quit," 
or leave, the filelist screen. 

Finding Files in the List: If your list takes up only one 
screen, it's easy to find any file at a glance. But what if 
you have many files, and the list takes up more than 
one screen? There are several ways to find files in your 
list. 
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Scrolling through the List: If the list takes up more 
than one screen, you use PF keys to " scroll" through it. 
PF7 scrolls backward one full screen. PF8 scrolls 
forward one full screen. By pressing these keys 
repeatedly, you can scroll through the list for as many 
screens as you want. 

Rearranging the List: The files in the list are arranged 
by date and time, newest to oldest. The date and time 
refer to the last time a file was changed (or if it was 
never changed, when it was created). If you'd like the 
list arranged in a different way, you can use these PF 
keys: 

PF1 

arranges files alphabetically by filename. 

PF4 

arranges files by filetype. 

PF5 

arranges by date, newest to oldest. This is how the 
list is arranged initially. You might use this key if 
you rearranged the list, and want to put it back to its 
original order. 

PF6 

arranges by size, biggest to smallest. 

Using the LOCATE Command: If you know a 
filename and/or filetype, you can use the XEDIT 
command LOCATE to find it quickly. This method is 
faster than scrolling through the screens, looking for a 
certain file. You enter a LOCATE command on the 
command line at the bottom of the screen, next to the 
large arrow. Then press the ENTER key. 

For example: 

====> LOCATE/FILE*} WORK/ 
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If FILE4 WORK is located, the line containing it 
becomes the first line on the screen (and is highlighted). 
If it isn't found, a message will tell you so. 

Variations on the FILELIST Command: You can use 
the FILELIST command to display a list of all the files 
on your A-disk or only some of the files. 

You can ask for a list that contains all files that have 
the same filename, or the same file type, or all files that 
begin with a certain letter, etc. 

If you don't specify a letter for "filemode," a filemode 
of A is assumed. If you specified B, all files on the B 
disk would be listed. 

To see a list of all the files on your A-disk with the 
filetype WORK, you would enter: 

FILEL * WORK 

The asterisk means "all." Typing an asterisk where 
you'd normally type a filename means that you want 
the list to contain all filenames with the filetype work. 

The FILELIST command can also be used to list files 
having the same filename, but different filetypes. Just 
use an asterisk where you would normally type the 
filetype. For example: 

FILEL FiLE1 * 

The list would contain all files whose filename is 
FILEl. 

If you want to create a file and don't remember if you 
already have a file with the file label you want to use, 
you can enter: 

FILEL filename filetype 

If the file exists, the file list will show only that file. If 
not, a message tells you that the file was not found. 
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Sometimes you may not remember a whole filename or 
a whole filetype. When you have many files, this can 
happen. You can give the computer ' 'clues" to display 
the list of files you want. 

For example, suppose you know you have a number of 
files whose filenames all start with FILE and whose 
filetype is WORK. You want the list to contain all 
these files. You would enter: 

FILEL FILE" WORK 

The command means, you want the list to contain all 
files whose filename starts with FILE and whose 
filetype is WORK. The resulting file list might contain 
these files: 



FILE1 


WORK 


A 


FILE2 


WORK 


A 


FILE3 
FILE4 


WORK 


A 


WORK 


A 


FILE5 


WORK 


A 


FILE6 


WORK 


A 



You can use an asterisk to represent any letters you 
can't remember. The asterisk can be used anywhere in 
the filename or filetype. 

Editing a File from the List: You know that to get a 
copy of a file on your screen, you use an XEDIT 
command. You can type an XEDIT command on the 
file list, next to the large arrow at the bottom of the 
screen. Then press the ENTER key. An easier way is 
to: 

• Move the cursor to the line describing the file you 
want to edit. 

• Then press PF1 1 (which is set to the XEDIT 

command). 

This does exactly what entering an XEDIT command 
does. The file appears on the screen, replacing the file 
list. 
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When you are finished editing the file and enter FILE 
or QUIT, the file list returns to the screen. The cursor 
remains on the line that describes the file you just 
edited, and an asterisk (*) appears in the "Cmd" space 
(next to the filename). This is just to remind you that 
you did something with this file. It does not prevent 
you from working with this file again. 

Discarding a File: You can use the DISCARD 

command to get rid of files you no longer want. To 
discard a file, you 

• Type DISCARD in the "Cmd" space next to the 
file (or files) you no longer want. If the command 
name is longer than the space provided, just type 
right over the information already in that line. 

• Press the ENTER key to execute the command. 

IMPORTANT NOTE: 

DISCARD is one of several commands that you can type 
in the "Cmd" space next to the filename. After you type 
a command in the "Cmd" space, you must press the 
ENTER key to carry it out, or "execute" it. 

Once a DISCARD command is executed, the computer 
doesn't ask if you'd like to think it over. The file is gone. 
So, if you have any doubts, you're safer if you use a 
command to rename a file. 

Renaming a File: You can change the filename or 
filetype (but not the filemode) of a file with the 
RENAME command. 

You type the RENAME command in the "Cmd" space 
next to the file you want to rename. You execute it by 
pressing the ENTER key. The format of the RENAME 
command is: 

RENAME / newfilename newfiletype filemode 
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First you type RENAME in the "Cmd" space. You 
continue typing the rest of the command right over the 
information that is already on the line. The slash (/) is 
a kind of shorthand. It stands for the file label of the 
file you want to rename. You then type the new file 
label (filename filetype filemode). Press ENTER to 
carry out the RENAME command. 

Copying a File: By using the COPYFILE command, 
you can make a copy of a file, make changes in it, and 
keep both the original file and the copy. 

You type the COPYFILE command starting in the 
"Cmd" space next to the file you want to copy. Press 
the ENTER key to execute the command. The format 
of the COPYFILE command is: 

COPYFILE / newf \ lename newfiletype newf i lemode 

First you type COPYFILE in the "Cmd" space. You 
continue typing the rest of the command right over the 
information that is already on the line. The slash (/) 
stands for the file label of the file in this line. You then 
type the new file label (filename filetype filemode). 
Press the ENTER key to carry out the COPYFILE 
command. 

Comparing Two Files: If you want to see how two 

similar files are different, you can use the COMPARE 
command. This command shows you only those lines 
that are different. 

You type the COMPARE command in the "Cmd" 
space next to the file you want to compare. Press 
ENTER to execute the command. The format of the 
COMPARE command is: 

COMPARE / filename filetype filemode 

First you type COMPARE in the "Cmd" space. You 
continue typing the rest of the command right over the 
information that is already on the line. The slash (/) 
stands for the file label of the file in this line. You then 
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type the file label (filename filetype filemode) of the 
file you want to compare it with. Press the ENTER key 
to carry out the COMPARE command. 

After you press the ENTER key, you see this message: 
COMPARING namel typel A WITH name2 type2 A. 

If the files are identical, nothing else is displayed. The 
status space (lower right corner) displays a MORE... 
notice. To get the file list back on the screen, press the 
CLEAR key. The file list comes back on the screen 
with an asterisk in the "Cmd" space. 

If the files are different, the lines that don't match are 
also displayed. The first line is from the first file, and 
the second line is from the second file. After all lines 
that are different are displayed, the message FILES DO 
NOT COMPARE appears. If one file is shorter than 
the other, you'll see this message: PREMATURE EOF 
ON filename filetype filemode. The screen will display 
MORE... in the status area. Press the CLEAR key to 
return to the file list. 

Using the LISTFILE Command 

The LISTFILE command displays the names of files. 
LISTFILE is useful when all you want to do is display 
file directory information. If you anticipate that you 
will want to edit, copy, rename or perform other file 
maintenance functions on the files in the list, you will 
probably find that FILELIST is more useful. 

To display a list of files using LISTFILE, you type 

LISTFILE (filename) (filetype) (filemode) 

The same rules apply for using LISTFILE as for 
FILELIST. 

Notice that CMS displays the list one line at a time, 
rather than in full-screen mode, which makes it 
impossible to do further operations with the list on the 
screen. You may find that for some functions, 
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LISTFILE responds more quickly than FILELIST. For 
example, if you want to see a list of all filenames 
beginning with "UG" on your A-DISK, 

1 i stf i le ug' c ,c a 

will display the list on your screen faster than 
FILELIST. Two more examples of using LISTFILE 
follow. 

If you type the LISTFILE command with the ALL 
option, 

1 istf i le ug* (all 

you will see more information about your files. 



Fi lename 


Fi letype 


Fm Format 


Lrecl 


Recs 


Blocks 


UGDISK 


SCRIPT 


A1 V 


Ik 


153 


9 


UGFILES 


SCRIPT 


A1 V 


71 


78 


k 


UGOUTLIN 


SCRIPT 


A1 V 


6k 


10 


1 


UGPFKEY 


SCRIPT 


A1 V 


72 


)k 


1 


UGPROF 


SCRIPT 


A1 V 


70 


10 


1 


UGSORT 


SCRIPT 


A1 V 


Ik 


25 


2 


UGSYN 


SCRIPT 


A1 V 


Ik 


2k 


2 


UGLIST 


SCRIPT 


A1 V 


Ik 


51 


3 



If you type the LISTFILE command naming a specific 
disk to be searched, with the DATE option, 

1 i stf i le ug* * b (date 

you will see still more information about the files on the 
specific disk you requested. 



F i lename 


F i letype 


Fm Format 


Lrecl 


Recs 


Blocks 


Date 


Time 


UGDISK 


SCRIPT 


B1 V 


Ik 


153 


11 


1/25/85 


9:30 


UGFILES 


SCRIPT 


B1 V 


71 


78 


5 


1/25/85 


9:2*+ 


UGLIST 


SCRIPT 


B1 V 


Ik 


51 


3 


1/23/85 


10:12 


UGOUTLIN 


SCRIPT 


B1 V 


(>k 


10 


1 


1/23/85 


1^:35 


UGPFKEY 


SCRIPT 


B1 V 


72 


]k 


1 


1/16/85 


11:38 


UGPROF 


SCRIPT 


B1 V 


70 


10 


1 


1/25/85 


16:14 


UGSORT 


SCRIPT 


B1 V 


Ik 


25 


2 


1/23/85 


8:11 


UGSYN 


SCRIPT 


B1 V 


Ik 


2k 


2 


1/16/85 


12:12 



There is an additional function in LISTFILE that is not 
available from FILELIST. LISTFILE has an option 
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called EXEC that will store the list in an EXEC file 
named CMS, instead of displaying it on the screen. For 
example, when we enter the LISTFILE command with 
the EXEC option: 

LISTFILE UG* * A (EXEC 
LISTFILE builds this file: 



SI 


S2 


UGDISK 


SCRIPT 


A1 


SI 


S2 


UGFILES 


SCRIPT 


A1 


S1 


S2 


UGLIST 


SCRIPT 


A1 


SI 


S2 


UGOUTLIN 


SCRIPT 


A1 


SI 


S2 


UGPFKEY 


SCRIPT 


A1 


SI 


S2 


UGPROF 


SCRIPT 


A1 


si 


S2 


UGSORT 


SCRIPT 


A1 


SI 


S2 


UGSYN 


SCRIPT 


A1 



The "&1 &2" at the beginning of each line have special 
meaning in an EXEC file. When you learn more about 
EXEC files, you'll find uses for that information. You 
should rename the file if you want to save it for later 
use. Remember, LISTFILE will replace the CMS 
EXEC with a new copy every time you specify the 
EXEC option. 
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Printing Files 



When you want one of your files printed, you can use 
the PRINT command. 

You can print any screen displayed on your terminal by 
pressing the shift key and the RESET (PrtSc) key. The 
screen will be printed on your Personal Computer 
printer. 

Note: You can stop any printing that's in progress by 
issuing the command: 

PURGE PRINTER ACTIVE 

This cancels only the current printing. To cancel all 
printing you've asked for, issue the command: 

PURGE PRINTER ALL 

(You can also cancel a specific print by specifying the 
print number (nnn) instead of ALL.) 



PRINT Command 



You can type the PRINT command either on the 
command line or on a FILELIST screen. Its format is: 

PRInt filename filetype filemode 

You must specify at least the PR of PRINT. You also 
must specify the filename and filetype. If you don't 
specify a filemode, VM/PC will assume the filemode is 
A. See "PRINT" on page 7-153 for further 
information about options you may specify. 
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See "An EXEC to Print a File" on page 5-45 for an 
example of using EXECs to make your printing easier. 



Printing on the Host System 

If you are using a Host Session, you can use any 
Printing method available to the Host System. The 
DCF Program Product, often referred to simply as 
SCRIPT, is an example of something that might be 
available on a Host System. 

You can use the printers of your host VM system by 
spooling your local printer output to the host VM 
system. (When the Host Services program is running in 
the host VM session. See Chapter 6, "Host Services" 
on page 6-1. You may also tag the files to send print 
files to other printers in your VM network. 

To send a print file to your host VM system, you: 

1 . Start the VMPCSERV program in your Host 3270 
Session. 

2. SPOOL your local printer to the correct class. 

3. (optionally) Issue the appropriate TAG command. 

4. PRINT the file. 

Normally, your local printer is spooled to class *. If 
you change this class, printer files are spooled to your 
host VM system, where the VMPCSERV program 
issues the appropriate printer commands. When you 
want to use your local printer again, you spool your 
printer class back to *. 

You may also spool your printer to or for another user, 
in the same way that you might do this on your host 
VM system. See "SPOOL" on page 7-54 and "TAG" 
on page 7-62 for further information. 
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Writing EXECs 



What is an EXEC? An EXEC is a file with a filetype 
of EXEC. It contains a series of commands that are all 
executed when you enter the filename of the EXEC 
file. 

An EXEC can help you by simplifying routine tasks. 
How does it do this? You have learned that you 
sometimes need to type several commands to do a task. 
If you find yourself often keying in the same sequence 
of commands during your terminal sessions, you can 
create an EXEC that contains the commands you 
would otherwise need to type. All these commands are 
executed when you enter the filename of the EXEC. 
An EXEC can also "prompt" (display a message), 
asking you to enter information that the system needs 
to complete the task you've given it. 

In this section, you'll learn how to create simple 
EXECs. You'll learn some of the features of the 
Restructured Extended Executor (REXX) language, 
which has special keywords called instructions that are 
used to tailor your EXECs to meet your needs. (Note: 
This book refers to the EXEC 2 language as well as the 
REXX language. While both are supported, the REXX 
language is the preferred language for EXECs.) 

More information on EXECs can be found in the 
VM/SP System Product Interpreter User's Guide and the 
VM/SP System Product Interpreter Reference. 
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An EXEC to Print a File 



You can use the PRINT command to print one copy of 
a file. But if you wanted five copies, you'd first have to 
enter a SPOOL PRINT COPY 5 command. Your first 
EXEC will contain these two commands. An EXEC 
can have any filename (up to eight letters long) and 
must have a file type of EXEC. Let's call this file 
MYPRINT EXEC A. 

Enter: 



In our examples, we will show command keywords and 
REXX keywords in capital letters, and everything else 
in lowercase letters. To enter characters in mixed case 
in XEDIT, you must issue SET CASE M. (You will 
also notice that in EXECs, we use quotation marks 
around command keywords. We'll explain more about 
this later.) 

Now enter an INPUT command and type these lines. 
In the PRINT command, use the file label of one of 
your files instead of workl file. 

, "' >'s <f)u-c prints 5 copies of a file. "/ 

"SPOOL PRINT COPY 5 M 

"PRINT workl file" 

•;-, )Cl , pasNT COPY 1 M 

Now press the ENTER key twice to return to edit 
mode. Let's look at the lines in this EXEC. 

/* This exec prints 5 copies of a file. */ 
The first line in a REXX EXEC must be a 
comment. A comment starts with /* and ends 
with */. It's a good idea to use the comment 
line to describe your EXEC. The comment line 
identifies the EXEC as written in the REXX 
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language, telling VM/PC to call the System 
Product Interpreter to handle it. 

"SPOOL PRINT COPY 5" 

is the command you use to get more than one 
copy printed. In this case, you are asking that 
five copies be printed. 

"PRINT workl file" 

This command gives the filename and filetype 
of the file you want printed. 

"SPOOL PRINT COPY 1" 

resets the number of copies printed to one. 

Enter a FILE command. The EXEC is now on your 
disk. How do you use it? Just type the filename 
MYPRINT on the command line and press the ENTER 
key. 

Creating an EXEC is like creating a new command. 
Each time you want five copies of this file printed, all 
you need do is enter MYPRINT # 

Now, the MYPRINT EXEC is good for printing five 
copies of the file specified in the PRINT command. 
But what if you want three copies, not five? And what 
if you want a different file printed? Do you have to 
write a different EXEC for every file? No, you can 
make a few changes in the MYPRINT EXEC so that 
you can use it to print any number of copies of any file. 

Enter XEDIT MYPRINT EXEC and ma ke the 
following additions and changes: 

/" This prints any number of copies of any file. 5 V 

SAY "Enter number of copies/ 1 

PULL num 

SAY "Enter filename and filetype." 

PULL fn ft 

"SPOOL PRINT COPY" num 

"PRINT" fn ft 

"SPOOL PRINT COPY" 1 



5-46 VM/PC User's Guide 



SAY is a REXX instruction that displays a "prompt" 
message on the screen. Prompt messages ask you to 
enter information. In this example, the first SAY 
instruction asks the user to enter the number of copies. 
The second SAY instruction asks the user to enter the 
filename and filetype. Notice that the prompt should 
be enclosed in quotation marks. 

PULL is a REXX instruction. The words after the 
PULL instructions (num, fn, and ft) are names of 
variables. You can use any names you'd like for 
variables. They are called variables because their value 
varies, depending on what you type in response to the 
prompt. 

The PULL instructions assign values to these variables. 
The first PULL instruction assigns the value you type 
to num. The second PULL instruction assigns the first 
word you type to fn and the second word you type to ft. 

Let's look at the other changes you made. In the 
SPOOL command, you changed the number of copies 
to num. In the PRINT command, you changed the 
filename and filetype (workl file) to fn and ft. The 
values that you type in response to the prompts replace 
these variable names in the commands. 

Now when you enter MYPRINT, you will be prompted 
for the number of copies you want printed, the 
filename, and the filetype of the file you want printed. 
The values you type will replace num, fn, and ft in the 
EXEC. 

Let's see how this works. Enter a FILE command. 
Then enter this command to start the EXEC: 

mypr i nt 

Respond to the first prompt with the number of copies 
you want, and respond to the second prompt with the 
filename and filetype of one of your files. For example: 
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System asks: Enter number of copies. 

You type: 3 

System asks: Enter filename and filetype. 

You type: workl file 

The PULL instruction takes the values you enter and 
assigns them to num, fn, and ft. 

This command: Becomes this command 

for this execution: 

"SPOOL PRINT COPY" num SPOOL PRINT COPY 3 

"PRINT" fn ft PRINT WORK1 FILE 

You can use a different number and a different 
filename and filetype each time you enter MYPRINT. 

When Should I Use Quotation Marks? 

You should use quotation marks around command 
keywords in REXX EXECs to set them off from 
variable names. Because you can use any name for a 
variable name, this prevents a potential mixup between 
keywords and variables that have the same name. It 
also makes your EXEC easier to read. 

In addition, when a command has special characters, 
they must be enclosed in quotation marks. 

Do not use quotation marks in the REXX instructions, 
except where specified (for example, around the 
prompt message). 
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Setting Up Your System to Meet Your 
Needs 



Finding Out Basic Information 

To find out your userid, and the date, time, and day of 
the week, use this command: 

====>| Dent ify 

You'll get a message like this one: 

USERID AT * VIA * 01/23/85 12:01:00 LOCAL WEDNESDAY 



How Much Disk Space Have I Used? 

When you enter a FILE command, a file is stored on a 
disk. The disks are identified by letters, known as 
filemodes. The filemode that you usually use when you 
create a file is "A." That means that your file is put on 
your A-disk. You can find out how much disk space is 
left with this command: 

====> Query D I SK A 

If you do not specify the disk letter, VM/PC displays 
the disk information for all currently-accessed disks. 

The response is a message similar to this: 

LABEL CUU M STAT CYL TYPE BLKSIZE FILES BLKS USED-(%) BLKS LEFT BLK TOTAL 
mydisk 101 A R/W FB C:PC 1024 8 206-20 8l8 1024 

The disk label is mydisk. The "address" of the disk 
(where the disk is) is 101. The filemode letter is A. 
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R/W means that you can read and write on this disk. 
Some disks are R/O, which means "read only." That is, 
you can't write a file on them. The fields labeled CYL, 
TYPE, and BLKSIZE give information about the 
amount of space on this particular disk device and how 
that space is organized. FILES tells you how many files 
you have on the A-disk. BLKS USED shows the 
percentage of the space you have used. Here, you see 
that 20% of this disk is used. Therefore, 80% of this 
A-disk is still available. 

You can get this information for any minidisks that you 
have ACCESSed by entering the appropriate filemode 
letter in place of A. 



How Does CMS Choose Programs and Files? 

When you enter a command, or specify a file name to 
XEDIT, CMS looks for a matching command name 
(EXEC or MODULE) or filename among those on the 
minidisks you have currently ACCESSed. If you have 
ACCESSed more than one minidisk, CMS begins its 
search with the letter closest to the beginning of the 
alphabet, and progresses through the hierarchy until it 
either finds the command or file, or it has searched all 
ACCESSed minidisks. 

If you notice that commands that have worked in the 
past and files that used to be accessible have suddenly 
disappeared, check CMS's search order to be sure that 
you have access to the minidisks on which the data 
resides. You can use the QUERY SEARCH command 
to determine which minidisks CMS will search for 
programs and data, as well as the order in which the 
search will be done. In addition, CMS will tell you the 
ACCESS mode and the read/ write status of each disk 
in the search hierarchy. R/O means ' 'Read/Only" and 
R/W means "Read/Write." 

A host minidisk must appear as R/W, if you want to 
"Upload" files from VM/PC to your host system. You 
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may "download" files from a host system with either 
Read or Write access to a host minidisk. 



Modifying the ACCESS List 

You can add disks or change the search order of the 
disks in the list by using the ACCESS command. You 
can drop a disk from the list by using the RELEASE 
command. 

Before you can ACCESS a disk, however, you need to 
make it available to your virtual machine by using the 
CP LINK command. CP LINK is also the means by 
which you can alter the read/ write status of a minidisk. 
To find out which minidisks are LINKed to your virtual 
machine, use the QUERY DASD command. 

The DETACH command is useful for eliminating 
LINKs to minidisks that you no longer want to 
ACCESS. You can drop a minidisk from the CMS 
search hierarchy and simultaneously destroy the LINK 
with the following command: RELEASE nnn (DET . 

The example below shows you how to use these 
commands and data to set up a local VM/PC session 
with access to a set of minidisks owned by your host 
virtual machine. 

query search 



Mydisk 101 A R/W 

System 100 S R/0 

Ready; 
query dasd 






DASD 100 FB-512 C R 2300 
DASD 101 FB-512 C W 2048 
DASD 10E FB-512 C R 2048 
Ready; , j. ^, „_,, 
cp link " 191 271 mw 


BLK CMS 
BLK 
BLK CMS 


100 
10E 


DASD 271 LINKED R/W; R/W 
Ready: 
access 271 z 


BY YOUR ID 




R cp d Ytnk systems 500 500 


ff tOOls 




Ready; ._„ 
access 500 t 







Ready; 
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In this example, you can see that, initially, we have 
ACCESS to two of the three minidisks that are LINKed 
to our virtual machine. QUERY SEARCH gives us 
information about the ACCESSed minidisks, and 
QUERY DASD tells us about the LINKs. 

The two pairs of LINK and ACCESS commands that 
follow the QUERY DASD provide us with access to 
information and programs residing on the 191 
(A-DISK) and 500 disks on our host system. (We had 
already started the Host Services program, 
VMPCSERV, on the host system.) The * means 
whichever user is logged on to the Host Session on this 
machine. 

Note: Linking to the 191 disk in mw (multiple write) 
mode on the host can be dangerous since more than one 
user can write to a disk at the same time. However, in 
this example, you are both the host and local user and 
can control what is written to the disk. 

The following QUERY SEARCH and QUERY DASD 
commands show that the LINKs and ACCESSes have, 
indeed, been successful. 



Ready; 














query search 












Mydisk 101 


A 




R/W 








System 100 


S 




R/0 








TOOLS 500 


T 




R/0 








A-DISK 271 


Z 




R/W 








Ready; 














query dasd 














DASD 100 FB- 


■512 


C 


R 2300 


BLK 


CMS 


100 


DASD 101 FB- 


■512 


C 


W 2048 


BLK 






DASD 10E FB- 


■512 


C 


R 20^8 


BLK 


CMS 


10E 


DASD 271 REMOTE 




W 




YOUR ID 


191 


DASD 500 REMOTE 




R 




SYSTEMS 


500 


Ready; 















Next, suppose that we no longer want WRITE 
ACCESS to the 191-DISK on the host system, but that 
we want to continue to refer to data and programs in 
READ/ONLY mode. To make that change, we must 
DETACH the R/W LINK to 191, and reestablish the 
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LINK as R/O. The following example shows you how 
to change a minidisk from R/W to R/O. 

release z (det 
DEV 271 DETACHED 
Ready; 

cp 1 ink * 191 271 rr 
DASD 271 LINKED R/O; R/W BY YOUR I D 
Ready; 

access 271 z 
Ready; 



An Easy Way to Link Local and Host Sessions 

After you have linked your local VM/PC session and 
your Host 3270 session, you can transfer files from one 
system to the other. This transfer is referred to as 
upload and download. 

You can simplify the setup process for upload and 
download by saving the appropriate commands in an 
EXEC file. If you name each EXEC file with a name 
that you can easily associate with the process you want 
to complete, setup becomes a matter of typing a single 
command (the EXEC filename). You can see examples 
of two very simple EXECs below that perform the 
LINK and ACCESS needed to allow you to share data 
and programs between host and local sessions. 

The first example is UPLOAD EXEC and the second is 
DOWNLOAD EXEC. 

(/"This is the UPLOAD EXEC*/ 

'release 271 (det" 
"1 ink x 191 271 mw" 

access 271 z 
exi t 

/|' c This is the DOWNLOAD EXEC*/ 
'release 271 (det" 
"1 ink 3C 191 271 rr il 
"access 271 z 
exi t 

Once you have filed away UPLOAD EXEC and 
DOWNLOAD EXEC, UPLOAD and DOWNLOAD 
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become part of CMS's command vocabulary. When 
you type either word, CMS will carry out the 
commands contained in the designated EXEC file just 
as though you had typed them on your terminal. 



Establishing Automatic LINKs and 
ACCESSes. 

While we're on the subject of EXECs, CMS uses a 
special EXEC called PROFILE that it runs 
automatically every time you IPL CMS. One way you 
can use this feature is to store the LINK and ACCESS 
commands that establish the data sharing relationships 
you most often use in the PROFILE EXEC. You can 
also store other favorite commands in your PROFILE, 
so that you can be sure that they will be executed each 
time you begin a CMS session. And if, during a 
session, you discover that you have somehow lost a 
LINK or an ACCESS, typing " PROFILE" ma Y add 
back the 'lost" minidisk. 

Note: Remember that if you have LINK and ACCESS 
commands for a host system in a PROFILE EXEC, you 
must ensure that VMPCSERV has been started in the 
host system before the PROFILE EXEC is executed, if 
you want to use those disks on your local system. 



Sharing Data and Programs with Other Users 

Before long, you may find it useful to be able to share 
data and programs with other users. As you saw earlier 
in the section on linking Local and Host sessions, 
VM/PC allows you to LINK and ACCESS data and 
programs associated with other host virtual machines 
(users). You may also LINK and ACCESS data and 
programs with other virtual machines that have been 
defined in your VM/PC system. 
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Note: Before you can link to a local virtual machine, 
you must add information about the local virtual 
machine and its associated minidisks to your 
Configuration File. See Chapter 3, "Configuring Your 
VM/PC System" on page 3-1, for information on 
updating your Configuration File. 

VM/PC is shipped with a virtual machine named 
SAMPLE defined in the Configuration File. The 
following example shows how to LINK to and 
ACCESS that virtual machine's A disk (101). 

cp link sample 101 201 rr abcl23 
access 201 b 

You have linked to disk 101 of the virtual machine 
whose userid is SAMPLE. You have defined that 101 
disk as 201 to your system. You asked only for read 
access to the disk (rr) and you specified the read-share 
password for the 101 disk (abcl23). 

After you linked to the 101 disk as 201, you 
ACCESSed the 201 disk as disk B on your system. 

You can issue the FILELIST command for the B disk 
to ensure that you have access to the files on the 
SAMPLE virtual machine's 101 disk. 

f i lei ist * * b 

This will list all the files on SAMPLE'S 101 A disk, 
which is the 201 B disk on your system. 

Since you LINKed to the disk in read-only mode (rr), 
you can copy, examine, sort, and compare data in its 
files, but you cannot alter their contents. This is a very 
good way to allow other users to access data but 
prevent them from changing it. 

If you want to change data on a disk, you must have 
write access to the disk. To get write access to 
SAMPLE'S A-disk, issue the LINK and ACCESS 
commands like this: 
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cp link sample 101 201 w xOyOz 
access 201 b 

The commands are the same as in the example above, 
except for "w xOyOz" at the end of the LINK 
command, "w" indicates that you want read-write 
access to the disk, and "xOyOz" is the write-share 
password. (Remember that the password you gave 
earlier, "abcl23," was called the read-share password.) 

When you no longer need access to a disk, you end your 
link to the disk with this command: 

re) 201 (det 

You can keep often-used LINKs and ACCESSes handy 
in EXEC files that you can call when you want to 
access data on another disk. You might give the EXECs 
appropriate names, like GETSAM EXEC to provide 
access to the SAMPLE virtual machine. 



A Sample PROFILE EXEC 



We have included some useful commands to link Local 
and Host sessions in the sample PROFILE EXEC 
below. In this example, we have already begun Local 
and Host sessions and started the VMPCSERV 
program in our Host 3270 Session virtual machine. If 
we do not start VMPCSERV before CMS runs this 
PROFILE, the LINK to the host disk (in 
DOWNLOAD EXEC) will fail. 



/"This is a sampl 


le PROFILE 


EXEC 5 ' 


V 


EXEC SETPF 








SYNONYM EASY2USE 








TERM HI LIGHT ON 








TERM PA2 HALF 








SPOOL PRINT CHAR 


80 






DOWNLOAD 








EXIT 
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PF Keys Make Work Simpler 

You may have noticed that the sample PROFILE 
EXEC contains another EXEC command, called 
SETPF. We have listed the contents of SETPF EXEC 
below so that you can see how commands can be 
assigned to the Program Function (PF) keys (labeled 
Fl through F10 on the left side of your keyboard). 
(You could also set a value for PF1 1 and PF12.) 

/"This is a sample SETPF EXEC*/ 

SET PF1 IMMED FILELIST 

SET PF2 IMMED QUERY DISK 

SET PF3 DELAY LOG 

"SET PF4 DELAYED IC RELEASE NNN (DET M 

SET PF5 IMMED UPLOAIJ 

SET PF6 IMMED DOWNLOAD 

SET PF7 IMMED QUERY DASD 

SET PF8 IMMED QUERY PRINT ALL 

SET PF9 IMMED QUERY SEARCH 

SET PF10 RETRIEVE 

EXIT 

Of course, you can reassign the keys at any time with a 
CP SET PF(number) command. However, placing the 
assignments in an EXEC, and calling it from the 
PROFILE EXEC is a convenient way for you to 
establish a standard set of Function key assignments for 
every CMS session. 

Note: The example above uses a SET command 
feature new with VM/PC in the PF4 setting. After this 
setting, when you press PF4, the command RELEASE 
nnn (DET will be displayed on the command line. The 
new feature is that the cursor will be positioned right 
under the nnn. This makes it easier for you to type in 
the replaceable part of the command. See "SET" on 
page 7-50 for further details on this feature. 
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Reviewing What You Have Done 

There are two features you can use to help you review 
what you have done and do it again. 

Scrolling Screen Contents 

The first of these is called scrolling. You use 
commands to redisplay information that has previously 
been displayed on your screen. You type these 
commands on the lower right of your screen, on the 
next-to-last line, following the word "Scroll:." This 
feature is only available in a Local 3270 Session. The 
commands you can use, and their meaning, are: 

• F[nn] - Scrolls forward (bottom of screen moves to 
top) one screen. If you specify a number for nn, it 
scrolls forward that number of lines. 

• B[nn] - Scrolls backward (top of screen moves to 
bottom) one screen. If you specify a number for 
nn, it scrolls backward that number of lines. 

• TOP - Scrolls so oldest entry is at top of screen. 

• BOT - Scrolls so latest entry is at bottom of screen. 

• R[nn] - Scrolls screen to the right 80 characters or 
the number you specified as nn. 

• L[nn] - Scrolls screen to the left 80 characters or 
the number you specified as nn. 

Note: Both the R and L scroll commands work 
only if you have issued the command TERMINAL 
WRAP OFF. See "TERMINAL" on page 7-64 for 
more information. 

Note: Both the scrolling commands and the 
RETRIEVE command (described below) use an area 
called the history buffer. VM/PC also uses this buffer 
when displaying on the screen, such as when you TYPE 
a file. Be aware that the contents of the history buffer 
may be covered (and lost) by something displayed on 
the screen. 
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Retrieving Commands 



You can set a PF key to RETRIEVE (as we did in the 
example in "PF Keys Make Work Simpler" on 
page 5-57). If you issue the command 

set pflO retrieve 

each time you press the PF10 key VM/PC will 
redisplay the last command you issued. Press PF10 
again and VM/PC will redisplay the next-to-last, and 
so on. The commands are redisplayed on the command 
line and you can reissue them by simply pressing the 
ENTER key. 

You can also change the command before you reissue 
it. This can save you a lot of typing and time. Try it. Set 
a PF key to retrieve as shown above, and then press it 
and watch what happens. 

When you have set a PF key to retrieve, if you place the 
cursor on a line you previously entered and press the PF 
key, the line will be written in the input area. You can 
then enter the input again, or alter it before entering it. 
You can scroll the display back to reach input not 
currently displayed. 

When you have selected an input line in this way, 
successive pressings of the PF key will retrieve input 
lines previous to the one selected. 



Using Synonyms in Your Work 

You can give your VM/PC a character all its own by 
giving alternative names to the commands. Once again, 
look at the sample PROFILE EXEC. The second 
command in the file, SYNONYM, will inform CMS 
that you want certain commands to be recognized by 
names that you have specified in the synonym file 
named EASY2USE SYNONYM, file. You can name 
the synonym file anything you like, provided its filetype 
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is SYNONYM. You can also have several synonym 
files stored on your minidisks. At any given time, CMS 
will recognize only the synonyms stored in the file you 
named in the last SYNONYM command. You can see 
the contents of the EASY2USE SYNONYM file used 
in the sample PROFILE EXEC in this example: 



XEDIT 


CREATE 


GETHOST 


DOWNLOAD 


ERASE 


DELETE 


QUERY 


HOWMUCH 


QUERY 


WHAT 



k 

There are just a few more things you should know 
about synonym files: The first field specifies a CMS 
command, the second specifies a synonym, the third 
specifies the minimum number of characters required to 
recognize the command, and synonyms can be used 
only for CMS commands. CP will not recognize 
synonyms for its commands. 

You can use the SYNONYM command at any time, to 
swap synonym files, or to reestablish the original 
synonyms. If you issue the SYNONYM command 
without specifying a filename, CMS will list the 
currently active synonyms, both yours (if any), and 
those supplied with the system. 



Controlling Your Display 

VM/PC has several options on the CP TERMINAL 
command you can use to control what is seen on your 
display. These options are HILIGHT, PA2, and WRAP. 
"TERMINAL" on page 7-64 contains a description of 
the TERMINAL command and all its options. 
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Highlighting Your Input 



Specify if you want all 

input from the keyboard to be highlighted on the 
display. You can do this to help you identify the 
commands you typed among all that is displayed. 



Scrolling a Half Screen 



Specify if you want VM/PC 

to scroll the display forward one-half screen when you 
press PA2 with the cursor in the input area. If you do 
this without specifying this command, VM/PC scrolls 
the screen forward one full screen. 

If you press PA2 while the cursor is on a displayed line, 
VM/PC will scroll that line to the top of the display 
screen. Remember that for VM/PC the PA2 key is 
emulated by pressing the Alt and F2 keys. 



Displaying Long Lines 



Specify if you want VM/PC 

to display each input line on a display screen line. With 
this option, lines that are longer than a screen line will 
be cut off at the right edge of the screen. VM/PC will 
put an ellipsis (...) on the end of the displayed portion 
of such lines to indicate that there is information not 
displayed. You can use the L and R commands in the 
scrolling area to see the rest of these lines. 

If you do not specify TERMINAL WRAP OFF, any 
part of a input line longer than a screen line will be 
"wrapped around" and displayed on the following line. 
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Transferring Personal Computer DOS 
and VM/PC Files 



Files created on the Personal Computer and those 
created on a VM/PC system are in different formats. 
VM/PC provides commands to convert these files from 
one format to the other so they can be used on either 
system. These commands are IMPORT and EXPORT. 

You can transfer data and programs between the IBM 
Personal Computer environment and the VM/PC 
environment with the IMPORT and EXPORT 
commands. IMPORT transfers from Personal 
Computer DOS to VM/PC, and EXPORT transfers 
from VM/PC to Personal Computer DOS. 

As with other VM/PC commands, IMPORT and 
EXPORT have many options that offer you many ways 
to use the system. The following sections show you how 
to use these commands and options to move a typical 
text file and a program from one environment to the 
other. (For our purposes, a text file is one that contains 
alphanumeric data.) 

For more information see "IMPORT" on page 7-138 
and "EXPORT" on page 7-109. 



Copying a Text File from Personal Computer 
DOS to VM/PC (IMPORT) 

To transfer a Personal Computer text file (named 
sample.fil on your C disk) to your VM/PC (as sample 
file on your A disk), you could use the following 
options on the IMPORT command: 
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import c: sample. fi 1 sample file a (ascii eol 
I I I I I I I III 



l_ eol means use 
end-of-1 ine 
characters to 
def ine 1 i nes 

ascii means convert the 
f i le's format to EBCDIC 
from ASCI I 



this is file's identifier on VM/PC 
Personal Computer filespec for the file 
_ import says copy a Personal Computer DOS file to VM/PC 



If the records in the file are longer than 80 bytes, you 
must specify the record length with the LRECL option 
(for example, lrecl 132). If you don't know the record 
length, you can use the Personal Computer DOS 
command 'dir' to find it. (Note that you will have to 
leave VM/PC to issue this command, then restart 
VM/PC.) 

If you used this IMPORT command, the Personal 
Computer DOS file named sample.fil on your C disk 
would be copied onto your VM/PC A disk. The file 
would be converted from ASCII to EBCDIC and any 
end-of-line characters would be used to indicate line 
ends in the VM/PC file. 

You do not have to IMPORT files to your A disk. 
Simply change the file mode letter on the IMPORT 
command and you can copy the file onto any disk you 
have accessed in write mode (even a host VM disk 
linked via VMPCSERV). Similarly, you can EXPORT 
files from any accessed disk. 
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Copying a Text File from VM/PC to Personal 
Computer DOS (EXPORT) 

Say that you have done the IMPORT shown above, 
then made some changes to the SAMPLE FILE A file, 
and now want to copy the changed file back to your 
Personal Computer C disk. You could use the 
EXPORT command with the following options to do 
that: 



export sample file a c : sample. f i 1 (ascii eol rep 

I I I I l_l 

|_ means replace 
exi sting file 
with this name 

_ ascii means convert the 
file's format to ASCI I 
from EBCDIC 

export says copy a VM/PC file to Personal Computer DOS 



The other operands and options are as explained for 
IMPORT above. Because you specified the option 
'rep', the old C disk file named sample.fil will be 
replaced with the one copied from VM/PC. 

Note: You must specify the complete Personal 
Computer DOS filespec and the VM/PC filename, 
filetype, and filemode each time you issue the IMPORT 
or EXPORT commands. 



Copying a Program from Personal Computer 
DOS to VM/PC (IMPORT) 

If you have a file whose record length is 1200, you can 
use the IMPORT command with these options to copy 
a program (or binary file) from the Personal Computer 
DOS to VM/PC environment: 
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import c : my prog. com myprog command a (noascii noeol lrecl 1200 

As with the text file IMPORT shown above, the 
Personal Computer file on the C disk (named 
myprog.com) is copied onto your VM/PC A disk 
(named myprog command). However, different options 
are given here. NOASCII means don't convert the file 
from ASCII to EBCDIC when it is copied. NOEOL 
means don't use any end-of-line characters in the file to 
define line ends in the new file. 

Note that in general, you will use the "ascii" option 
with the "eol" option if you are copying text files, and 
the "noascii" option with the "noeol" option if you are 
copying programs. 



Copying a Program from VM/PC to Personal 
Computer DOS (EXPORT) 

If you want to copy the program back onto your 
Personal Computer C disk, you could use this 
EXPORT command and options: 

export myprog command a C:myprog.com (noascii noeol rep 



The only difference here from the IMPORT command 
used above is the option 'rep'. That means replace the 
file named myprog.com on the C disk with the file 
being copied. 
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Chapter 6. Host Services 



Overview 



VM/PC provides Host Services that enable you to use 
the resources of a host VM system in a number of 
ways. 

With the 3270 Coaxial Connection, you can use your 
Personal Computer XT/370 or AT/370 as a 3270 
terminal to the host VM system. Whether it appears as 
a 3277-2, 3278-2, or 3279-S2A depends on the 
hardware you have. See Chapter 4, "Getting Started" 
on page 4-1 for details. 

In this Host 3270 Session, you can LOGON to a host 
VM system. You can use a Host 3270 Session 
concurrently with a Local 3270 Session. For example, 
while you are editing a local file in the Local Session 
you can be compiling a program in parallel on the Host 
Session. We describe the Host 3270 Session in greater 
detail in the following section. 

When you use the Host 3270 Session in conjunction 
with the VM/PC Host Services program 
(VMPCSERV), in your Local 3270 Session you can 
use: 

1 . Host Minidisks - In your Local Session, you can 
LINK and ACCESS any CMS format minidisk that 
exists on the host VM system you are connected to 
(assuming you know the appropriate minidisk 
addresses and passwords). Even though these disks 
are not local to you, both you and your applications 
can utilize these disks as if they were in fact local. 
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Host Files - When you have linked to, and accessed, 
host minidisks, you can access files on those disks 
as if the files were indeed local. 

Host Printers - The Host Services program allows 
you to use your host VM system printers as 
VM/PC printers. For example, if your installation 
has defined Class K as the print class for an IBM 
3800 printer, then you need only SPool your 
VM/PC printer to CLASS K. When you use the 
CMS command PRINT to print a file, that file will 
be printed on the IBM 3800 from the host VM 
system. 



VM/PC Host Services Program Features 

The Host Services program (called VMPCSERV) 
allows you to: 

1. LINK and ACCESS any CMS format minidisks on 
the host VM system as if those disks were local; 

Such minidisks are called host minidisks. You can 
access and use the minidisks as if they were located 
on your local VM/PC system, but in fact they are 
really minidisks on your host VM system. When 
you read or write programs and data from or to 
these minidisks, the read or write requests are 
executed by the Host Services program. The local 
programs function as if the read or write were being 
done locally, when it is really being done by the 
host system, as a result of the local system 
requesting the host services program to do the work 
for it. 

2. Access any file on these disks in the normal VM 
fashion for local file access. 

3. Spool printer output to any of the printers on the 
host VM system as if those printers were local. 
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Host Services Modules 

To use the Host Services described above, you must 
have access to the four required Host Services files on 
the host VM system. They are: 

1. VMPCSERV EXEC 

2. VMPCDEVT MODULE 

3. VMPCSR77 MODULE 

4. VMPCSR78 MODULE 

If you do not have access to these files, you must install 
the Host Services program. The following section 
describes how to install the Host Services program (also 
referred to as VMPCSERV). 

Installing Host Services Program 

To use VM/PC Host Services, you must install the 
Host Services program on your Host VM system. Host 
Services features are only available over the 3270 
Coaxial Connection between VM/PC and your host 
VM system. 

Notes: 

1. If the VM/PC Version 1 Host Services file, 
VMPCSER V EXEC, is on your host VM system, you 
MUST rename it before you install VM/PC Version 
1.1 Host Services. 

2. If Host Services has already been installed on your 
host VM system, perhaps by the System Programmer, 
you need not install it yourself. Simply have the 
necessary files (VMPCSERV EXEC, VMPCDEVT 
MODULE, VMPCSR77 MODULE, and 
VMPCSR78 MODULE) made available to you. You 
might want to put them on your A disk at the host VM 
system. 

3. If you have already installed Version 1 Host Services 
on your system, you can install Version 1.1 Host 



Chapter 6. Host Services 6-3 



Services as shown in "Upgrading Version 1 Host 
Services Program " on page 6- 7. 

You install the Host Services program in three parts: 

• You load the HEXIN program in source code form 
using the EDIT command on your host VM system, 
assemble it, and the HEXIN module is then created. 

• You load the TEXT files needed to generate the 
VMPCDEVT, VMPCSR77, and VMPCSR78 
modules to your host system using the HEXIN 
module. 

• You use these TEXT files to create the 
VMPCDEVT, VMPCSR77, and VMPCSR78 
modules, and upload the VMPCSERV EXEC using 
the EDIT command on your host VM system. 

You will need approximately 400 blocks of space on 
your Host System's A-disk to Upload the Host Services 
files (if your A-disk is formatted in 1024-byte blocks). 

The host services program is contained on distribution 
diskette 3. Follow these steps to install it: 

• Step 1 - Bring up VM/PC (it is assumed that you 
have already installed VM/PC; if not, refer to 
Chapter 2, "Installing VM/PC" on page 2-1). 

• Step 2 - From the Session Selection Menu, select 
the Host 3270 Session. 

• Step 3 - Logon to your host VM system, IPL CMS, 
and enter the following commands (they may be 
executed from an EXEC if you prefer) : 

GLOBAL MACLIB DMSSP CMSLIB ( or t h e 
maclib names on your host system which 
contain the CMS macros) 

CP SET MSG OFF 
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CP SET WNG OFF 

CP SET ACNT OFF 

CP TERMINAL ESCAPE OFF LINEND OFF 
LINEDEL OFF LINESIZE 80 

CP TERMINAL HILIGHT OFF (if your 
system supports the HILIGHT option of the 
TERMINAL command) 

SET AUTOREAD ON 

SET BLIP OFF 

SET IMPEX OFF (if you have an exec called 
EDIT on your system which would invoke an 
editor other than the CMS EDIT editor.) 

Notes: 

1. If you have a synonym for EDIT, delete it before 
you continue installation. 

2. You will probably want to restore the SET and 
TERMINAL characteristics following this 
installation procedure. 

Step 4 - Now return to the Session Selection Menu 
(by pressing the Select key) and select the Local 
3270 Session. 

Step 5 - Insert installation diskette 3 in drive A, and 
logon to your local session using a userid of CMS, a 
password of CMS (if the default password has not 
been changed), and an Environment of CMS. 
Diskette 3 contains the CMS 101 minidisk where 
the Host Services program installation is found. 
You will receive a message when the Host Services 
program minidisk is automatically accessed, asking 
if you wish to continue with the installation. If you 
choose to continue, the files needed to create a 
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Host Services program (the exec and texts) are 
uploaded to your host VM system. 

The installation is performed in three parts. You 
will be prompted on the local session before the 
start of each part, where you may decide to perform 
the part, skip the part, or stop the installation of the 
host services. You should only skip the part if you 
are re-starting the installation, and are certain that 
this part has previously been completed 
successfully. 

While each part of the host services installation is 
being done, you should select the host session as 
your active session, and observe the installation 
procedure for correct functioning. If the message 
"NOT ACCEPTED" appears on your host session 
screen in the CP status area, you should consult the 
section "What To Do if Something Goes Wrong," 
which follows, for the procedure to follow to 
correct the error. In addition, the installation 
procedure may detect other errors, which will result 
in error messages being produced on the host 
session screen. You can switch between your local 
and your host sessions as you wish, but do not enter 
any commands or press any keys on your host 
session until the installation is complete. When you 
receive the messages that the VMPCDEVT, 
VMPCSR77, and VMPCSR78 modules have been 
created and the VMPCSERV exec has been copied 
to your host system, you can logoff from the CMS 
userid on the local session and logon your own 
userid. 

Step 6 - Return to the Host Session and check that 
no errors have been encountered (such as being out 
of minidisk space on your host minidisk, host failure 
in the middle of processing, etc). If the Upload 
procedure completed normally, the VMPCDEVT, 
VMPCSR77, and VMPCSR78 MODULES and the 
VMPCSERV EXEC should have been created on 
your host VM system CMS A-disk. Erase all other 
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files which were uploaded as they are no longer 
needed for the Host Services program processing. 

Note: The Host Services source and the VMPCSERV 
maclib are contained on the CMS 101 minidisk on 
installation diskette 1 . These files are in a packed 
format produced by the CMS Copyfile command. 



Upgrading Version 1 Host Services Program: If you 

have already installed the Version 1 Host Services 
program on your system, you can install Version 1 . 1 
Host Services by simply: 

1. Inserting VM/PC Version 1.1 installation diskette 
3 in drive A, and logging on to your local session 
using a userid of CMS, a password of CMS (if the 
default password has not been changed), and an 
Environment of CMS. Diskette 3 contains the 
CMS 101 minidisk where the Host Services 
installation is found. You will receive a message, 
when the Host Services program minidisk is 
automatically accessed, asking if you wish to 
continue with the installation. Answer quit 

2. Select your Host 3277 Session and rename your 
Version 1 VMPCSERV EXEC file. For example, 
the command: 

rename vmpcserv exec a1 vmpcser! exec a1 

will rename it VMPCSER1 EXEC (it must have an 
EXEC filetype). 

3. Start the Version 1 Host Services program by 
entering VMPCSER 1 9 or whatever you renamed 
VMPCSERV in the previous step. (It must be a 
3277 Session.) 

4. Return to the Local Session and issue the LINK and 
ACCESS commands to link your local session and 
your host session. You must be linked in write 
mode. 
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For example, the commands: 

cp link hostuserid 191 271 mw 
access 271 t 

would link the 191 disk from the host system to the 
local system as disk 27 1 in multiple write mode and 
access that disk as local disk t. (Replace hostuserid 
with the userid you use at the host system.) 

5. Upload the 4 Host Services files to the desired host 
minidisk. If you wanted them on a disk you had 
accessed as mode "t," you would issue these 
commands: 

copyfile vmpcserv exec a = = t 

copyfile vmpcdevt module a = = t 

copyfile vmpcsr77 module a = = t 

copyfile vmpcsr78 module a = = t 

You now have the Version 1 . 1 Host Services program 
installed on your host system. 

Note: If, for any reason, you wish to continue to use 
Version 1 Host Services, save the renamed Version 1 
VMPCSERV EXEC file. 

What To Do if Something Goes Wrong 

The Host Services installation depends on your host 
VM system being ready to read lines of data which are 
sent to it from your local VM session. The local session 
tries to pause between each line sent to your host 
system, to allow the host system to finish processing 
previous lines sent. Occasionally, however, the 
installation will not be accomplished because your host 
system is not ready to receive lines from the local 
session. In this case, your host system will display 
"NOT ACCEPTED" in the CP status area. If this 
happens consistently during the install process, you 
should stop the installation and restart it on your local 
session with the command "INSTALL delay-value." If 
you followed the above steps during the installation, the 
INSTALL exec was invoked by the CMS user's profile 
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with a delay value of 100. When you restart the 
installation, you should invoke the INSTALL exec with 
a larger delay value (150 or 200). If the installation 
continues to fail, you should continue to increase the 
delay value. Prior to re-starting the installation, you 
should erase any files created by the install process on 
your host system A-disk. 

The Host Services program installation places 20 files 
on your host VM system. If you have files there with 
the same names as those Host Services is trying to 
install, the installation will fail. Before installing Host 
Services you must rename or erase any files on your 
host VM system that have these filenames and 
filetypes: 

DISPAX TEXT 
DISPIO TEXT 
GENPCSER EXEC 
HEXIN ASSEMBLE 
HSTCMS TEXT 
HSTCMSD TEXT 
HSTCOM TEXT 
HSTCOMD TEXT 
HSTFSR TEXT 
HSTGMEAC TEXT 
HSTGMELN TEXT 
HSTHYPE TEXT 
HSTLOGO TEXT 
HSTLOGOD TEXT 
HSTSPL TEXT 
HSTVSI TEXT 
HSTVSID TEXT 
HSTDEVT TEXT 
VMPCSERV EXEC 
VMPCDEVT MODULE 
VMPCSR77 MODULE 
VMPCSR78 MODULE 

If the uploading of one or more text files in part 2 of 
the install fails, but the HEXIN module has been 
created successfully on your host system, you can 
restart the install process by issuing the command 
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" ] 'v * "••.'_" on the local session, and skip part 1 of the 
install. You may also load the text files in part 2 of the 
install selectively if only 1 or 2 of the files was not 
loaded successfully. Before restarting the installation, 
you should erase any of the text files uploaded to your 
host system which you will be trying to upload again. 



Host Services Program 



Host Services is a host VM application program that 
runs in your Host 3270 Session under your userid. 
Host Services simply passes on requests from the local 
VM/PC session to the host VM system for processing. 

Clearly, you could explicitly logon to the host VM 
system (in a host session) and perform explicit LINKs 
to minidisks, run programs, etc. If you do this, though, 
these resources are not available to applications running 
in the local session environment. What the Host 
Services program does is to make these resources 
available to the VM/PC local environment as perceived 
local resources. 

To use Host Services, you must logon to the host VM 
system (by selecting a Host 3270 Session and 
performing the logon). 

Since the Host Services program runs as an application 
under your userid in a Host 3270 Session, you cannot 
run another CMS application on the Host 3270 Session 
unless you terminate the Host Services program. 

To start the Host Services program, just enter 

(when in a Host 3270 Session). The 
Host Services program displays the following screen: 
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Figure 6-1. VMPCSERV Logo 



To stop the Host Services program, press PF3. You 
will then return to a normal Host 3270 Session and can 
explicitly perform any host service, but your local 
session will no longer be able to access any of these 
host services or files. 

After starting Host Services in your Host 3270 session, 
use the Select key to return to the Session Selection 
Menu. There, select a Local 3270 Session and, if you 
haven't done so already, logon and IPL VM/PC CMS. 
You now can use these Host Services: 

1 . Host minidisks 

2. Host files 

3. Host printers. 
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Host Minidisks 



You can access host CMS format minidisks when you 
are in the VM/PC CMS local environment. You can 
access programs and utilities which are on your host 
VM system without having to copy them to a VM/PC 
disk. Such programs are available for your use in the 
Local 3270 Session as if they were on one of the local 
minidisks on your VM/PC system. 

To use these host minidisks issue the CP command 
LINK. 

• VM/PC CP searches to see if the minidisk that you 
are trying to link to is local. If it is local, the disk is 
linked according to the rules governing the CP 
LINK command. 

• If VM/PC CP determines that the minidisk does 
not exist locally, rather than failing to perform the 
link, VM/PC CP sends a request to the Host 
Services program in your Host 3270 Session to issue 
your LINK request. Assuming that the minidisk 
exists there (and that you have provided the 
appropriate password) the link is performed and 
you are then told that you can proceed as normal. 

You can always determine when a minidisk is truly local 
or at the host by issuing a CP QUERY DASD 
command. If a minidisk is local, the device type 
displayed will be FB-512; if a minidisk is at the host, 
the device type displayed will be REMOTE. 

When reviewing the LINK command (see "LINK" on 
page 7-35), you will notice an optional keyword of 
REMOTE/LOCAL. (To review, the LINK command 
in VM/PC CP is of the form:) 

LINK [TO] userid vaddr [AS] vaddr2 [mode] 
[[PASS=] password] [REMOTE I LOCAL] 

You may specify REMOTE or LOCAL, but not both, 
on a LINK command. These keywords are provided 
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specifically for those users who have the same userids 
and minidisk addresses on both their host VM system 
and on the VM/PC. As the normal search order for 
acquiring a minidisk is to search to see if the minidisk 
exists locally before determining if it exists on the host, 
there may be times when you want to explicitly LINK 
to a host minidisk and bypass your local one. For 
example, you may have a userid, say CASE, that has a 
290 minidisk both locally and at the host. Explicitly 
stating REMOTE on the the LINK command - LINK 
CASE 290 222 RR mypass REMOTE - will cause 
VM/PC to only perform the LINK on the host VM 
system. (Obviously, if the minidisk does not exist at 
the host then the LINK request will fail!). 

If you specify LOCAL on the LINK command, only a 
local VM/PC minidisk search will be performed. If the 
minidisk does not exist locally, the LINK command will 
fail. 

If neither LOCAL nor REMOTE is specified, the 
minidisk request will first be performed locally, and, if 
not found, the request will be performed at the host. 

Password specification rules are defined in "LINK" on 
page 7-35. The essential difference between the 
VM/PC minidisk password specification and that 
provided by your host VM system is that you will not 
be prompted for a password if the LINK is performed 
by the Host Services program. You must specify the 
password on the LINK command in this case. 

Once you have performed a LINK to a minidisk, you 
must issue a CMS ACCESS command in order to 
identify the minidisk to CMS. ACCESS establishes the 
CMS file search sequence order by letting you assign a 
file mode to the minidisk. This command is 
independent of whether or not the minidisk is local or 
at the host. For descriptions of ACCESS and 
RELEASE (when you want to remove a minidisk from 
CMS) see "ACCESS" on page 7-84 and "RELEASE" 
on page 7-165. The counterpart to LINK is the 
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DETACH command (when you no longer need the 
minidisk). See "DETACH" on page 7-24. 

Once the LINK and ACCESS have been performed, 
you are ready to access files, in VM/PC CMS, from 
either local or host minidisks. 

Note: Temporary disks you have accessed in your host 
system will not be available to your local system. 



Host Files 



Whether or not a minidisk is really local or at the host, 
once you have performed LINK and ACCESS, you can 
access files on that disk using CMS and user-written 
programs. That is, you have the full range of CMS file 
commands at your disposal. 

At a high level, you can invoke an editor, to edit and 
modify any file; you can TYPE out a given file; you 
can COPYFILE any file; or you can compile a 
program. These commands are available to you even if 
the files exist on a host minidisk (in such cases we call 
the files host files). 

At a low level, you have available to you all of the CMS 
file system macros, such as: 

1. FSCB 

2. FSOPEN 

3. FSSTATE(W) 

4. FSREAD 

5. FS WRITE 

6. FSPOINT 

7. FSCLOSE 

You can use these macros in your programs to read and 
write data in both host and local files, without the 
application program having to be aware of where the 
file is actually located. Some applications which are 
dependent on certain CMS control blocks and internal 
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pointers may not work. For example, applications 
which search internal CMS control blocks for a file's 
FST may not work correctly. 

Also, any single read or write of data that your 
applications perform must be less than or equal to 
65535 bytes. Therefore, you should not read or write 
host files with a record length greater than 65535, or 
try to read or write more than 65535 bytes of a host file 
with a single file system operation. 



File Upload/Download 



Uploading refers to the sending of programs and data 
from your local VM/PC session to your host VM 
system. Downloading is the reverse; sending programs 
and data from your host system to your local VM/PC 
session. 

In VM/PC, there are no explicit file upload/download 
commands. Such data sending results from the CMS 
commands you issue in your local VM/PC session 
when the Host Services program is active. To upload a 
file to a host minidisk, do the following: 

1 . LINK to the host minidisk in write mode 

2. ACCESS the minidisk (for example as file mode Z) 

3. Use the CMS COPYFILE command (for example: 
to Upload a file DESSERT LIST, which is on your 
A disk, to your Z disk, the host minidisk, issue 

COPYFILE DESSERT L 1 ST A DESSERT L I ST Z 

This results in the file DESSERT LIST being copied 
from your A disk and being created on your Z disk; 
that is, being uploaded to your host minidisk. 

You download a file similarly, using the CMS copyfile 
command: 

1 . LINK to the host minidisk in read or write mode 
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2. ACCESS the minidisk (for example as file mode Z) 

3. Use the CMS COPYFILE command (for example: 
to download the file DESSERT LIST, which is on 
your Z disk, to your A disk, the local minidisk, issue 

COPYFILE DESSERT L I ST Z DESSERT L I ST A 

This results in the file DESSERT LIST being copied 
from your Z disk and being created on your A disk; 
that is, being downloaded to your local minidisk. 

You can also use the COPYFILE command to copy 
files between two host minidisks (both on your host 
VM system) or between two local minidisks. 

Thus, accessing files on your host VM system is as 
simple as accessing local VM/PC CMS files. 
Uploading and downloading files is as easy as 
transferring them between minidisks. 



Host Spooling 



In addition to providing you with host minidisks and 
files, Host Services also allows VM/PC to use the 
printers of the host VM system. This allows you to 
spool your local print output to the host VM system, 
when the Host Services program is running in your host 
VM session. In addition, you may also tag the files to 
send print files to other printers in your VM network. 

To send a print file to your host VM system, you: 

1 . Start the Host Services program in your Host 3270 
Session 

2. SPOOL your local printer to the correct class 

3. (Optionally) issue the appropriate TAG command 

4. PRINT the file. 
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Normally, your local printer is spooled class *. If you 
change this class, printer files are spooled to your host 
VM system, where the Host Services program issues the 
appropriate printer commands. When you want to use 
your local printer again, spool your printer class back to 
*. Printer output will be directed to your local printer. 

In addition to specifying a class on your host printer 
files, you may also spool your printer to or for another 
user, in the same way that you might do this on your 
host VM system. See "SPOOL" on page 7-54 and 
"TAG" on page 7-62 for descriptions of these 
commands. 

If you start to print a file on your host system and 
change the way that the printer is spooled as the file is 
being printed, the lines already printed have been sent 
to the host printer, and only following lines directed to 
the printer will be printed as you have requested with 
the new spool information. This is due to the way the 
Host Services program works. Later, we will take a look 
at how it works to understand how this is done. 



What to Do if Something Goes Wrong 

The Host Services program relies upon your host CMS 
session for its operation. If this session should be 
stopped due to processing errors in the requested host 
services, the host services will also be stopped. For 
instance, if an I/O error occurs on a host minidisk 
while you are using it through the host services, your 
host CMS session may terminate to preserve the 
integrity of the files on that disk, and the services of the 
host services are lost. 

If communication between VM/PC and the Host 
Services program (VMPCSERV) is interrupted or lost, 
you must do the following to restart communication: 
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1 . Restart the Host Services programat the host 
session (if it is still running there, press PF3 to stop 
it, then issue VMPCSERV to start it). 

2. Redo the link, access, spool, and tag at the local 
session. 

The host services will invoke some CMS services in 
your host system in such a way that no terminal output 
can be created by the CMS service. To do this, the 
host services spools the output only to a console file, 
and then purges this file after the CMS service is 
completed. The exec which invokes the host services 
closes any console file you may have so that you will 
not lose it when the host services purges the console 
file. If the CMS service invoked terminates your host 
CMS session, you should issue the command SPOOL 
CONSOLE TERM STOP. This will once again allow 
you to see console output in your host session, and you 
can re-ipl your host CMS session. 



How the Host Services Program Works 

This section is an overview of how Host Services works. 
You do not need to know how Host Services works to 
use it to do your work. 

When you start Host Services in your host VM session, 
all of your CMS minidisks, except your S-disk, are 
released. These disk modes will be used when you 
request ACCESSes to be done for you on VM/PC for 
host minidisks. 

The Host Services program then tries to establish 
communications with VM/PC. The Host Services 
program and VM/PC communicate by using the 3270 
Coaxial Connection which connects VM/PC to the 
host system. These communications are performed in 
the VMPCSERV command by doing Diagnose X'58' 
reads and writes of the data. 
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While these communications are taking place, you 
cannot do any other work on your host system, since 
Host Services is running. 

When the communication is established, the Host 
Services program displays a full-screen logo, which tells 
you that the Host Services program is active. This logo 
is displayed on your Host 3270 Session, until you stop 
Host Services, to remind you that you have host 
services active. 

The Host Services program then waits for requests from 
VM/PC. The Host Services program can perform a 
number of different services for you, as we have seen 
previously. Each type of service requested from 
VM/PC is internally identified by a Service Request ID 
and Sub-function ID. The actual values for these 
identifiers are set by VM/PC when it requests a host 
service for you. The Host Services program recognizes 
what the request is for, based on these identifiers, and 
calls the appropriate service within Host Services to 
service the request. 

For instance, if you issued the command "LINK * 191 
191" on your local session, and you did not have a 
locally defined 191 minidisk, VM/PC would send a 
request for a LINK to the Host Services program. Host 
Services would perform the LINK on your host VM 
system, and the results of the LINK command would be 
sent back to you. (Note that LINK * is only valid if the 
userid of the local and host systems are the same). 

Additionally, if you issued the command "ACCESS 
191 Z" on your local CMS session and 191 was a host 
minidisk, VM/PC would send an ACCESS request to 
the host VM session where the Host Services program 
would perform the actual ACCESS of the minidisk. The 
Host Services program uses the same mode letter which 
you specify to perform the access. Therefore, the Host 
Services program issues the CMS command "ACCESS 
191 Z" and the host access is done. 
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Likewise, a file being printed on your host system uses 
the host printer services of the Host Services program. 
When your local program prints a line, the request is 
sent to the Host Services program, which invokes the 
printer services of Host Services to actually print the 
line on your host printer. Thus the host printers are 
accessible to programs running in your local CMS 
session. 

All host services are performed for you in your host 
session, as requested by you from the local session. 
Thus if you write to a file on a host minidisk, the local 
session sends a request and the data to be written to the 
Host Services program, which actually performs the 
write to the file you specified. 

The Host Services program continues to wait for 
requests to be done until you stop it by pressing the 
PF3 key. At this time, Host Services releases all of the 
minidisks which you have accessed from the local VM 
session, and detaches all virtual devices acquired during 
the time the host services program was executing. Host 
Services recorded which disks were accessed when it 
started execution, and restores those minidisks to your 
CMS environment by accessing them as you had them 
accessed originally. Host Services then terminates 
processing, and your host CMS session is restored. 

Collecting Names of Files Downloaded to VM/PC 

Your host system installation may want to 
automatically monitor Host Services for particular 
downloaded file traffic. For instance, they may want to 
prevent users from copying certain modules to the local 
VM/PC environment, or keep track of who is using 
particular files in the VM/PC environment from the 
host. 

Whenever a file system read of record 1 is detected, the 
HSTFSR module (which is part of Host Services) gives 
control to a routine named HSTACC (if there is one). 
A user could write an HSTACC routine to generate an 
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accounting record with the date, time, and fileid of the 
file being accessed. 

Here's a simple example of an HSTACC accounting 
routine. 

**************************************************************** 



* 


This 


rout ine will use CP 


* 


an accounting record to 


* 


Host 


System. 


******** 


****** 


******************* 


HSTACC 


ENTER 






LA 


R2,ACTTIME 




DIAG 


R2,R15,X'0C' 




MVC 


ACTFNAME, 0(R1) 




MVC 


ACTFTYPE, 8(R1) 




MVC 


ACTFMODE, 16(R1) 




LA 


R2, ACTDATA 




LA 


R3,X'10' 




LA 


Rh, LACTDATA 




DIAG 


R2,R3,X'^C 




DROP 


R1 




SR 


R15.R15 




RET 




ACTDATA 


DS 


OD 


ACTTIME 


DS 


CL8 




DS 


CL8 


ACTFNAME 


DS 


CL8 


ACTFTYPE 


DS 


CL8 


ACTFMODE 


DS 


CL2 


LACTDATA 


EQU 


*-ACTDATA 




REGEQU 




END 


HSTACC 



Diagnose X'4C' to produce * 

track reading a file from the * 

* 

* 

******************************* 

Point to area for the time 

Get the date and time of day 

Get the f i lename 

Get the f i letype 

Get the f i lemode 

Get address of account data 

Subcode X ' 10 ' 

Length of user information 

Issue diagnose for account 



Date MM/DD/YY 

Time HH:MM:SS 

Name of file being read 

Type of file being read 

Mode of file being read 



Note: ENTER and RET are macros that can be found 
on the CMS 101 minidisk in VMPCSERV MACLIB. 

In this very simple example, when record 1 of a file is 
requested, HSTFSR calls the HSTACC routine to 
generate accounting information, which can be 
collected by the Host System Installation for analysis. 
The actual format of the accounting data would not 
have to match what is done here, as this is merely an 
example of what might be done. If you use system 
accounting services, see the publication VM/SP System 
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Programmers Guide for information on user accounting 
requirements. 

The HSTACC routine could even check the filename 
and filetype against a table of CMS fileids which the 
installation does not want copied to the local CMS 
environment. If read access to the file was to be 
restricted, a bad return code could be returned to the 
caller of the FSREAD routine in VMPCSR77 or 
VMPCSR78 module, to prevent the copying of this 
particular data. 

See the next section for further information. 

Setting Up an HSTACC Routine: The HSTACC 

routine will get control whenever the first record of a 
host file is read at the request of the local VM/PC 
system. This routine is in the main stream of Host 
Services and must observe certain rules. 

Host Services is a program run in the users' area at 
X'20000' which already restricts the use of many 
system as well as other CMS functions and programs. 
The HSTACC routine must preserve the user 
environments and return them to their original state. If 
the environment is altered in the routine, it must be 
restored upon exit. When Host Services terminates 
after PF3 is pressed, the original user environment is 
restored as it was before the VMPCSERV EXEC was 
run. 

If there is a secondary entry point (HSTACCFE - 
accounting final exit) defined in the primary exit 
routine, it will be given control during Host Services 
termination. The user can then cleanup and close spool 
files and undo whatever the accounting exit did. The 
HSTACCFE entry point will be given control at 
register 15. The exit must return on register 14. 
Register 5 will contain the actual return code of the 
termination of Host Services. Code 3E8 means the 
normal exit was taken (PF 3 key was pressed). Code 
3E9 means that Host Services is being terminated 
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because of an I/O error. No terminal or disk I/O 
should be performed. The original user environment 
will not be restored with this error (3E9). All other 
registers have no meaning but the data that they point 
to should not be destroyed by this user exit routine (for 
example, register 13 save area). 

The HSTACC routine must not issue commands that 
will allow the system to interrupt the Host Services 
processing (such as "CP SET MSG ON"). The Host 
and the VM/PC Local processors are paced and 
required to answer each other in a timely sequence. If 
this sequence is interrupted, the connection will be 
broken and Host Services will stop. It may be 
necessary to IPL the Host CMS to recover the machine. 

Remember if you use any spooling type functions in 
this exit, the local VM/PC user may also be using 
them. This could be confusing unless you save and 
restore the current values that the local processor set, 
prior to exiting from HSTACC each time. Spooling 
messages are impossible to stop and may interrupt Host 
Services. Unless the screen is reset in the host machine 
on time, Host Services may terminate. 

Because Host Services preserves the users environment 
and restores it at the completion of the service process, 
there are no disks accessed other than the system "S" 
disk. This is so that the local VM/PC can use all 25 
mode letters other than S. It is not recommended that 
any file I/O be performed in this EXIT. Diagnose 
"4C" should be used to create accounting data, but it is 
also possible to accumulate the transactions in buffers, 
and then send them to the accounting or other machine 
to be processed. See the description of the second entry 
point, above, for more information. 

HSTACC should only be used to accumulate or 
interrogate the names of the files that are being 
requested by the LOCAL processor (VM/PC). The 
exit will be given control with register one (Rl) 
pointing to the filename, filetype, and filemode. 
HSTACC could accumulate or filter the names of the 
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downloaded files and send formatted accounting 
records of them to an accounting machine or use the 
DIAG X'4C directly. The Accounting machine could 
then reduce the data and create a list of programs that 
are being used by the local VM/PC. 

Rules and Restrictions: The exit will be made 
available to the user if they follow these rules and 
restrictions when setting up an HSTACC routine. 

1. Naming conventions are: 

• Main entry name of the exit routine is 
"HSTACC TEXT." 

• Termination exit entry point name is 
"HSTACCFE." 

2. Install the user's exit by linking HSTACC together 
with other Host Services text decks. No attempt is 
made to find the HSTACC deck on any TXTLIB or 
LO ADLIB format libraries. Dynamic loading can 
not be performed. Link HSTACC together with 
Host Services service module by either: 

Making HSTACC available on a disk when 
Host Services is installed by the local VM/PC 
machine. 

-OR- 

Using the EXEC provided (GENPCSER) to 
load, and generate the modules in the host 
machine first by: 

• Saving the uploaded TEXT decks that make 
up VMPCSR77 and VMPCSR78. 

• Making the uploaded TEXT decks available 
when the GENPCSER EXEC is run that 
produces the modules. 
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• HSTACC must be in text deck form, and 
available (ACCESSed) at GENPCSER 
EXEC time. 

Note: GENPCSER EXEC will be uploaded 
to the host system during install of Host 
Services from the CMS 101 disk. 

3. User exit must return on Register 14. 

4. User exit does not use the current value in R13 as 
its save area. 

5. Zero register 15 on return, else the read will fail. 

6. User exit does not do any I/O to user disks (there 
are only the ones linked by the Local VM/PC 
available). 

7. User exit preserves and restores any settings of CP, 
CMS, and spooling that the EXIT may use before 
each return to Host Services. 

8. User exit does not use any of the CP commands 
that will interrupt the full screen environment. 

9. User exit does not issue any error messages to the 
terminal. 

10. User does not use any commands or functions that 
occupy location X'20,000'. 

11. The EXIT does not delay the return to Host 
Services to interfere with the pacing of the two 
processors (Acknowledgement is timed). 

12. Uses standard CMS Macro interfaces. 

It is recommended that you use the DIAGNOSE X'4C 
to send the user data to the system defined accounting 
machine. See the VM/SP System Programmer's Guide 
for information on the use of Diagnose X'4C and 
creating accounting records. 
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The HSTACC routine can use PUNCHC and CP 
DIAGNOSE commands to set up the environment to 
get the records to other accounting machines. (Spool 
classes other than the default ones are suggested.) The 
routine MUST NOT issue any commands that will 
disrupt the "quiet" environment that is needed to 
PACE the two processors. 

Contents of Parameter Lists: The HSTFSR module 
will pass the fileid of the file being read to the 
HSTACC routine in the following format: 

0(R1) = CL8'f ilename' 

8(R1) = CL8'f iletype' 

16(R1) = CL2'f ilemode' 

HSTFSR will pass the following to HSTACC in the 
Registers. 

R1 = The data is in the above format. 

R1 3 = Systems save area. 

Rl4 = Return pointer to Host Services at Exit time. 

R15 - Entry Pointer for addressability. 

HSTACC must clear register 15 or the return code 

will be passed back to the local VM/PC 

indicating that there was an error if R 1 5 is non-zero. 
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Chapter 7. VM/PC Commands 



This chapter describes the VM/PC CP and VM/PC 
CMS commands. 



Entering Commands 



A command consists of a command name usually 
followed by one or more positional operands and, in 
many CMS commands, by an option list. CP and CMS 
commands described in this publication are shown in 
the format: 



command name [operands...] [ (opt ions ...[)] ] 



You must use one or more blanks to separate each 
entry in the command line unless otherwise indicated. 
For an explanation of the special symbols used to 
describe the command syntax, see "Notational 
Conventions." 



The Command Name 



The command name is an alphameric symbol of one to 
eight characters. In general, the names are based on 
verbs that describe the function you want the system to 
perform. For example, you may want to find out 
information concerning your CMS files. In this case, 
you would use the LISTFILE command. 
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The Command Operands 

The command operands are keywords and/or positional 
operands of one to eight, and in a few cases, one to 
seven alphameric characters each. The operands 
specify the information on which the system operates 
when it performs the command function. 

For CMS commands: 

1 . Write the operands in the order they appear in the 
command formats, unless otherwise specified. 

2. Blanks may optionally be used to separate the last 
operand from the option list. 

3. Use a left parenthesis "(" as the beginning of an 
option list; it does not have to be preceded by a 
blank. 

The Command Options 

CMS command options are keywords used to control 
the execution of the command. The CMS command 
formats in "CMS Commands" show all the options for 
each CMS command. 

The option list must be preceded by a left parenthesis; 
the closing parenthesis is not necessary. 

For most commands, if conflicting or duplicate options 
are entered, the last option entered is the option in 
effect for the command. Exceptions to this rule are 
noted where applicable. 

Comments in CMS Command Lines 

You can enter comments on your console by using the 
CP * command. 

You can write comments with CMS commands by 
entering them following the closing parenthesis of the 
option list. The only exception to this rule is the 
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ERASE command, for which comments are not 
allowed. 



Notational Conventions 

The notation used to define the command syntax in this 
publication is: 

• Truncations and Abbreviations of Commands 

Where truncation of a command name is permitted, 
the shortest acceptable version of the command is 
represented by uppercase letters. (Remember, 
however, that CMS commands can be entered with 
any combination of uppercase and lowercase 
letters.) The following example shows the format 
specification for the FILEDEF command. 

Fl ledef 

This format means that FI, FIL, FILE, FILED, 
FILEDE, and FILEDEF are all valid specifications 
for this command name. 

Operands and options are specified in the same 
manner. Where truncation is permitted, the 
shortest acceptable version of the operand or option 
is represented by uppercase letters in the command 
format box. If no minimum truncation is noted, the 
entire word (represented by all uppercase letters) 
must be entered. 

Abbreviations are shorter forms of command 
operands and options. Abbreviations for operands 
and options are shown in the description of the 
individual operands and options that follow the 
format box. For example, the abbreviation for 
MEMBER in the PRINT command is MEM. Only 
these two forms are valid and no truncations are 
allowed. The format box contains: 
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MEMBER 



{ n £ me } 



and the description that follows the format box is 

MEMBER (name) 
MEM ( ' f ) 



The following symbols are used to define the 
command format and should never be typed when 
the actual command is entered. 

underscore _ 
braces { } 
brackets [ ] 
el 1 ipsis 

Uppercase letters and words, and the following 
symbols, should be entered as specified in the 
format box. 

asterisk * 

comma , 

hyphen 

equal sign = 

parentheses ( ) 

period 

colon : 

The abbreviations "fn," "ft," and "fm" refer to 
filename, filetype, and filemode, respectively. The 
combination "fn ft <fm>" is also called the file 
identifier or fileid. 

When a command format box shows the characters, 
fn ft fm or fileid and they are not enclosed by 
brackets or braces, it indicates that a CMS file 
identifier must be entered. 

If an asterisk (*) appears beneath fn, ft, or fm, it 
indicates that an asterisk may be coded in that 
position of the fileid. The operand description 
describes the usage of the *. 
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Lowercase letters, words, and symbols that appear 
in the command format box represent variables for 
which specific information should be substituted. 
For example, "fn ft fm" indicates that file 
identifiers such as "MYFILE EXEC Al" should be 
entered. 

Choices are represented in the command format 
boxes by stacking: 

A 
B 
C 

An underscore indicates an assumed default option. 
If an underscored choice is selected, it need not be 
specified when the command is entered. 

Example: 

The representation: 

A 
B 
C 

indicates that either A, B, or C may be selected. 
However, if B is selected, it need not be specified. 
Or, if none is entered, B is assumed. 

The use of braces denotes choices, one of which 
must be selected. 

Example: 

The representation: 



indicates that you must specify either A, or B, or C. 
If a list of choices is enclosed by neither brackets or 
braces, it is to be treated as if enclosed by braces. 
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The use of brackets denotes choices, one of which 
may be selected. 

Example: 

The representation: 

"a" 
B 
C 



indicates that you may enter A, B, or C, or you may 
omit the field. 

In instances where there are nested braces or 
brackets on the text lines, the following rule applies: 
nested operand selection is dependent upon the 
selection of the operand of a higher level of nesting. 

Example: 

Level 1 Level 2 Level 3 
[filename [filetype [f i lemode] ] ] 

where the highest level of nesting is the operand 
that is enclosed in only one pair of brackets and the 
lowest level of nesting is the operand that is 
enclosed by the maximum number of brackets. 
Thus, in the previous example, the user has the 
option of selecting a file by filename only or 
filename filetype only or by filename filetype 
filemode. The user cannot select filetype alone 
because filetype is nested within filename and our 
rule states: the higher level of nesting must be 
selected in order to select the next level (lower 
level) operand. The same is true if the user wants 
to select filemode; filename and filetype must also 
be selected. 

An ellipsis indicates that the preceding item or 
group of items may be repeated more than once in 
succession. 
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Example: 

The representation: 

(opt ions . . . ) 

indicates that more than one option may be coded 
within the parentheses. 
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CP Commands 



Format of CP Commands 

The command formats are described in alphabetical 
order except for special characters such as the asterisk 
(*) and the pound sign (#), which appear first. 

The command formats are presented in the following 
order: 

1. Command Name: Identifies the name of the 
command 

2. Description of Function: Describes the use 

3. Syntax: Lists the syntax of the command with all 
the possible operands that you can use 

4. Operand Description: Describes the function of 
each operand and any values that you can include in 
the operand 

5. Usage Notes: Contains notes about special uses of 
the command, its operands, or combinations of 
commands or operands. 

6. Responses: Describes the CP responses sent to the 
terminal, caused by execution of the command. 
These responses are command responses and are 
not to be construed as VM/PC system messages. 
The command responses are not prefixed and, 
therefore, they are not contained in Chapter 

8, "VM/PC Messages" on page 8-1. 
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Note: The execution of certain commands may 
produce system messages. Refer to Chapter 
8, "VM/PC Messages" on page 8-1 for information 
on system message formats and user action. 



Summary of CP Commands 

The following is a brief description of all the commands 
acceptable to the CP component of the VM/PC 
system. 



Command 


Usage 


* 


Annotate the terminal display 
screen. 


#CP 


Execute a CP command while 
remaining in the virtual machine 
environment. 


ATTN 


Make an attention interruption 
pending for the virtual machine 
console. 


BEGIN 


Continue or resume execution of 
your virtual machine at either a 
specific storage location or at the 
address in the current PSW. 


CHANGE 


Alter one or more attributes of a 
closed spool file. 


CLOSE 


Terminate spooling operations on 
the virtual machine printer. 



Figure 7-1 (Part 1 of 3). Summary of CP Commands 
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Command 


Usage 


CP 


Execute a CP command while 
remaining in the CMS virtual 
machine environment. 


DEFINE 


Reconfigure your virtual machine. 


DETACH 


Detach a device from your virtual 
machine. 


DISPLAY 


Display virtual storage on your 
terminal. 


DUMP 


Print the following on the virtual 
machine printer: virtual PSW, 
general registers, floating-point 
registers, and contents of specified 
virtual storage locations. 


EXTERNAL 


Simulate an external interruption 
for your virtual machine and 
return control to that machine. 


IPL 


Simulate IPL of the virtual 
machine. 


LINK 


Provide access to a specific 
minidisk by a virtual machine. 


LOGOFF 


Disable access to CP. 


ORDER 


Rearrange closed spool files in a 
specific order. 


PURGE 


Remove closed spool file from 
system. 


QUERY 


Request information about virtual 
machine configuration and system 
status. 



Figure 7-1 (Part 2 of 3). Summary of CP Commands 
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Command 


Usage 


REQUEST 


Make an attention interruption 
pending for the virtual machine 
console. 


SET 


Control various functions within 
the virtual machine. 


SPOOL 


Alter spooling control options; 
direct a file to the host system. 


STORE 


Alter specified virtual storage 
locations and registers. 


TAG 


Specify variable information to be 
associated with a spool file. 
Interrogate the current TAG text 
setting. 


TERMINAL 


Define or redefine the input and 
attention handling characteristics 
of your virtual machine console. 


TRACE 


Trace specified virtual machine 
activity at your terminal, spooled 
printer, or both. 



Figure 7-1 (Part 3 of 3). Summary of CP Commands 
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CP Commands and Options 



#CP 



Use the asterisk (*) to annotate the terminal display ( . 

screen data with a comment. The format of the * ^ 

(comment) command is: 



anycomment 



Use the #CP command to execute a CP command while 
in a virtual machine command environment without 
first signaling attention to get to the CP command 
environment. The format of the #CP command is: 



#CP 



[ command 1 i ne1 [#commandl i ne2 #...]] 



Where: 

command 1 i ne 

specifies the name and operands for the CP 
command or commands you want to issue. You 
must precede the first commandline with at 
least one blank. 

Usage Notes: 

1 . The pound sign (#) shown in the preceding format 
represents the logical line end symbol and is the 
default supplied by VM/PC. However, you may 
choose to redefine the logical linend symbol. If you 
have redefined the logical line end symbol, #CP is 
an invalid command; you must substitute your line 
end symbol for the pound sign when using this 
command. 
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2. For the command to operate, the following 
conditions must be met: 

• The virtual machine must be operating with 
SET LINEDIT ON (a default). 

• The first three characters of the edited line must 
be #CP (uppercase or lowercase) with the "#" 
representing the logical line end symbol 
currently defined. 

• At least one blank must separate the #CP from 
any command line. Do not use attention 
interruption in any part of the line or to enter 
the line. 

3. You can enter multiple command lines as operands 
of the #CP command provided that all command 
lines to be executed must be separated by the 
current logical line end symbol. 

4. If you enter #CP with no operands, the virtual 
machine enters the CP environment. 

Responses: If you enter #CP without a commandline, 
you receive no response. 

If you enter #CP with commandlines, you receive the 
responses appropriate to the individual commands you 
entered. 
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ATTN 



Use the ATTN command to make an attention 
interruption pending at your virtual console. The format 
of the ATTN command is: 



ATTN 



Usage Notes: 

1. The REQUEST command performs the same 
function as ATTN; the two commands can be used 
interchangeably. 

2. The BEGIN command is not required after you 
issue ATTN. 

3. CP ignores the ATTN and REQUEST commands if 
an I/O operation is in progress at the console or if 
other interrupts are pending for your virtual 
machine. This condition may result if you issue the 
ATTN or REQUEST command by means of 
DIAGNOSE X'8\ 
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BEGIN 



Use the BEGIN command to continue or resume 
execution in the virtual machine at either a specified 
storage location or the location pointed to by the virtual 
machine's current program status word (PSW). The 
format of the BEGIN command is: 



Begin 



[hexloc] 



Where: 

hexloc 

is the hexadecimal storage location where 
execution is to begin. 

Usage Notes: 

1 . When BEGIN is issued without hexloc, execution 
begins at the storage address pointed to by the 
current virtual machine PSW. Unless the PSW has 
been altered since the CP command mode was 
entered, the location stored in the PSW is the 
location where the virtual machine stopped. 

2. When BEGIN is issued with a storage location 
specified, execution begins at the specified storage 
location. The specified address replaces the 
instruction address in the PSW, then the PSW is 
loaded. 
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CHANGE 



Use the CHANGE command to alter one or more of 
the attributes for a closed spool file. The format of the 
CHANGE command is: 



CHange 



Pr interMspool id ) ( ) [NAme fn [ft]] 

prt Hall s \ Hold 

NOHold 



COPY nnn 



Where: 



PRINTER 
PRT 

changes printer files. 

spool id 

designates the spoolid of file to be changed. 

ALL 

changes all spool files. 

HOLD 

prevents the spool file being selected from the 
spool queue until released. The file is released 
by issuing a CHANGE command with the 
NOHOLD operand. 

NOHOLD 

releases the file from HOLD status. 

COPY nnn 

specifies the number of copies of the spool file 
you want. The value of nnn (number of copies) 
must be a number from 1 to 255; leading zeros 
are optional. 
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NAME fn [ft] 

assigns identification to the file in the VM/PC 
CMS format of filename and filetype. If ft is 
not specified, it is set to blanks. 

Usage Notes: 

1 . Issue the QUERY command to determine the 
current attributes of the file 

2. To CHANGE a file, it must have been closed but 
not yet selected from the spool queue. 

3. When issued from a local session, the CHANGE 
command only applies to files that are on the local 
spool queue. You must issue the VM/SP 
CHANGE command from the host session to 
change files that are on the host spool queue. 

4. Spool Files whose corresponding data file cannot be 
found will be placed in HOLD status and cannot be 
changed to NOHOLD. 

Response: 

nnnn FILE(S) CHANGED 

This response indicates the number of files 
changes; if none are changed nnnn will be NO. 
This response will not appear if you have issued 
the CP SET IMSG OFF command. 
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CLOSE 



Use the CLOSE command to indicate that the current 
spool data is to be collected into a spool file. The 
format of the CLOSE command is: 



Close 


(Printer/ 

PRT 
( dvcadr ) 


PURge 
FORM form 

fHOld "I [Dlst distcode][NAme fn[ft]] 
[NOHoldJ 





Where: 



PRINTER 
PRT 

closes the printer spool file. 

dvcadr 

closes the specified spool device. 

PURGE 

immediately purges the spool file. No spool file 
is created. 

FORM form 

specifies the form name for the spool file. The 
form name is a 1-8 alphanumeric value. If 
FORM is not specified, the file is created with 
the form name indicated by the last SPOOL 
command. 

HOLD 

overrides the SPOOL NOHOLD option and 
places the spool file in HOLD status. The file is 
released by issuing a CHANGE command with 
the NOHOLD operand. 

NOHOLD 

overrides the SPOOL HOLD option making the 
file immediately selectable for spool processing. 
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DIST [distcode] 

specifies the distribution code the spool file is to 
be given. 

NAME fn [ft] 

assigns identification to the file in the VM/PC 
CMS format of filename and filetype. If ft is 
not specified, it is set to blanks. 

Usage Notes: 

1 . The HOLD/NOHOLD options take precedence 
over the current spool attributes. 

2. The CLOSE command has no effect if the CONT is 
one of the current spool attributes. 

Responses: 

PRT FILE spool id SPOOLED 

This response indicates the spoolid created. 
This response will not appear if you have issued 
the CP SET IMSG OFF command. 

PRT FILE SPOOLED TOlFOR userid 

This response indicates the spool file has been 
routed to the Host Server. This response will 
not appear if you have issued the CP SET 
IMSG OFF command. 
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CP 



Use the CP command as an optional header on 
commands to CP in a CP environment. The format of 
the CP command is: 



CP 



[command 1 inel [#commandl i ne2 #...]] 



Where: 

command! ine 

specifies the name and operands for the CP 
command or commands you want to issue. You 
must precede the first commandline with at 
least one blank. 

Usage Notes: 

1 . The pound sign (#) shown in the format block 
represents the logical line end symbol currently in 
effect for your virtual machine. If you have 
redefined the logical line end symbol, you must 
substitute your line end symbol for the pound sign 
when using this command. 

2. The CP command is treated as a null line by the 
control program and therefore can precede any 
other command if one or more blanks separate CP 
from the other command. 

3. You can enter multiple command lines as operands 
of the CP command, but you must separate each 
command line by the logical line end (#) symbol. 

Responses: If you enter CP without a commandline in 
the CP environment, you receive no response. 

If you enter CP with commandlines, you receive the 
responses appropriate to the individual commands you 
entered. 
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DEFINE 



Use the DEFINE command to alter your virtual 
machine configuration. The format of the DEFINE 
command is: 



SET 




( IMSG 
LINED! 
RUN 


t &s 






< 


EMSG 


I Sf 1 

) CODE ( 

(text; 


► 






PFnn 


"iMMed pfdata1#. . . 

DELayed [ ICc] [BLb] pfdata1#. . . 
_RETrieve 


; 





Where: 



STORAGE [AS; 



\ nnnnK I 
JnM ) 



redefines the size of virtual storage allocated for 
the virtual machine as nnnnK (where K 
represents 1024 bytes) or nM (where M 
represents 1,048,576 bytes). If the virtual 
storage size is not specified as a multiple of 4k, 
it is rounded up to the next 4k boundary. 
Changing the size of virtual storage, causes the 
virtual machine to be reset. 

PRINTER [AS] dvcadr 

PRT 

1403 

redefines the virtual machine printer as a 1403 

with address dvcadr. 

3800 [AS] dvcadr 

redefines the virtual machine printer as a 3800 
with address dvcadr. 



Chapter 7. VM/PC Commands 7-21 



CONSOLE [AS] dvcadr 

redefines the virtual machine console with 
address dvcadr. 

TFB-512 [AS] dvcadr [BLK] nnnnn 

adds a temporary minidisk with device address 
dvcadr to the virtual machine configuration. If 
the keyword AS is omitted, dvcadr may not be 
A or AS. 

BLK nnnnn specifies the number of 512 bytes 
blocks to be allocated on the minidisk. 

dvcadrl [AS] dvcadr2 

redefines the device represented by dvcadrl as 
dvcadr2 

Usage Notes: 

1 . When you alter the virtual machine configuration 
with the DEFINE command, the changes are 
temporary and are in effect for the current terminal 
session only. The configurator must be used to 
make permanent alteration to the user's 
configuration. 

2. The maximum amount of virtual storage that can be 
defined is 4M for an XT/370, and 8M for an 
AT/370. 

3. If a DEFINE STORAGE is requested and sufficient 
DASD space is not available, the virtual storage will 
be defined as large as possible, and the response 
will indicate how much is available. 

4. If the virtual machine printer type (1403/3800) is 
changed and a spool file is currently open, the spool 
file will be closed. 
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Responses: 

STORAGE = nnnnK 
DEV dvcadr DEFINED 

These responses will not appear if you have 

issued the CP SET IMSG OFF command. 
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DETACH 



Use the DETACH command to remove a device from 
the virtual machine configuration. The format of the 
DETACH command is: 



DETach 



( dvcadr [dvcadr . . . ] 
) dvcadr 1-dvcadr2 



Where: 



dvcadr [dvcadr . . . ] 
dvcadr 1-dvcadr2 

dvcadr is the address of the device to be 

removed from the virtual machine 

configuration. To detach multiple devices, a 

blank is used to separate the device addresses. 

To detach a range of devices, a hyphen must be 

inserted between the addresses specified. 

Multiple addresses and a range of addresses 

cannot be intermixed on the same command 



Usage Notes: 

1 . You can detach a device that was temporarily 
defined by the DEFINE command, or one that is 
part of your permanent virtual machine 
configuration, except for the terminal or printer 
devices. 

2. You can detach a device even if it is currently in 
use. 



Response: 



DEV dvcadr DETACHED 

This response will not appear if you have issued 
the CP SET IMSG OFF command. 
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DISPLAY 



Use the DISPLAY command to display the following 
virtual machine components. The format of the 
DISPLAY command is: 



Di splay 



hexlod 
Lhexlod 
Thexlod 
Khexlod 



Gregl 



^ Psw 



III [^ ,oc2 ] 

{.} fbytecountl 
[_END J_ 



{.} fregcount 
[END 



% +Xddddd 



f {.} fbytecountl"] 

L Lend JJ_ 



' r59 ' [ ! : I Ul 2 ]] 



Where: 



hexlod 
Lhexlocl 
Thexlod 
Khexlocl 

is the first or only hexadecimal storage location 

in the virtual machine that is to be displayed. If 

L or no letter prefix is specified, the storage 

contents are displayed in hexadecimal. If T is 

specified, the storage contents are displayed 

along with the EBCDIC translation. If K is 

specified, the storage keys are displayed in 

hexadecimal. 

If hexlocl is not on a fullword boundary, it is 
rounded down to the next lower fullword. 
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If L or T is specified without any operand, or 
followed immediately by a blank, the contents 
of all virtual storage is displayed. 

The address may be from 1 to 6 hexadecimal 
digits; leading zeros are optional. 

- hexloc2 
: END 

is the last of a range of hexadecimal storage 
locations in the virtual machine to be displayed. 
If - or : is the first character of the operand, 
then hexlocl defaults to zero. If hexloc2 is not 
specified, storage is displayed from hexlocl to 
the end of virtual storage. If specified, hexloc2 
must be greater than hexlocl and within the 
virtual storage size. 

The address may be from 1 to 6 hexadecimal 
digits; leading zeros are optional. 

{.} bytecount 
END 

is the hexadecimal integer designating the 
number of bytes of storage to be displayed. The 
sum of hexlocl and bytecount must be an 
address that does not exceed the size of the 
virtual machine. 

The value may be from 1 to 6 hexadecimal 
digits; leading zeros are optional. 

Gregl 

is a decimal number from to 15 or a 
hexadecimal number from to F representing 
the first, or only, general register whose 
contents are to be displayed. If G is specified 
without a register number, the contents of all 
general registers are displayed. 

Yregl 

is an integer (0, 2, 4, or 6) representing the 
first, or only, floating-point register whose 
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contents are to be displayed. If Y is specified 
without a register number, the contents of all 
floating-point registers are displayed. 

- reg2 
: END 

is the last of a range of registers to be displayed. 
If - or : is the first character of the operand, 
regl defaults to zero. If reg2 is not specified, all 
registers of this type from regl are displayed. If 
specified, reg2 must be equal to or greater than 
regl. For general registers, reg2 may be a 
decimal number from to 1 5 or a hexadecimal 
number from to F; for floating-point registers, 
reg2 may be 0, 2, 4, or 6. 

{.} regcount 
END 

is a decimal number from 1 to 16 or a 
hexadecimal number from 1 to 10 designating 
the number of registers to be displayed. The 
sum of Gregl and regcount may not exceed 16; 
for floating-point registers regcount may not 
exceed 4. 

[%[+Xddd]] 

uses regl as an address with the optional 
hexadecimal displacement ddd. 

PSW 

displays the current virtual machine PSW 
(program status word) as two hexadecimal 
words. 

Usage Notes: 

1 . This command displays only second-level storage 
(storage which is real to the virtual machine). 

2. Multiple operands on a single command line will not 
be supported. 
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3. To terminate the DISPLAY function while data is 
being displayed, press the PA1 key. 

Responses: One of the following responses is displayed 
depending on the operand specified. 

Displaying Storage Locations 

xxxxxx wordl word2 word3 word4 [* EBCDIC 

Translation*] 

response when displaying storage locations; 
xxxxxx is the storage location of wordl. Up to 
4 words are displayed on a line with the 
optional translation (periods represent 
translation of nonprintable characters). 
Multiple lines are used for a range of locations. 
If translation is requested, alignment is made to 
the next lower 16-byte boundary; otherwise 
alignment is to the next lower f ullword 
boundary. 

xxxxxx TO yyyyyy SUPPRESSED LINE(S), 
SAME AS ABOVE... 

response when displaying storage locations that 
contain the same data as that displayed on the 
previous line; xxxxxx is the first storage location 
whose data display is suppressed; yyyyyy is the 
last location. 

Displaying Storage Keys 

xxxxxx TO yyyyyy KEY = kk 

response when displaying storage keys; xxxxxx 
and yyyyyy are the starting and ending storage 
addresses and kk is the associated storage key. 

Displaying General Registers 

GPR n = regl reg2 reg3 reg4 

response when displaying general registers; n is 
the register whose contents is regl. Up to 4 
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registers are displayed on a line for a range of 
registers; multiple lines are used if required. 

Displaying Floating-point Registers 

FPR n = xxxxxxxxxxxxxxxx .xxxxxxxxxxxxxxxxx 
E xx 

response when displaying floating-point 
registers; n is the register being displayed. The 
register is displayed in both the internal 
hexadecimal format and the E format. One 
register is displayed per line; multiple lines are 
used for a range of registers. 

Displaying the PSW 

PSW = xxxxxxxx xxxxxxxx 

response when displaying the PSW; the PSW is 
displayed as two hexadecimal words. 
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DUMP 



Use the DUMP command to print the contents of 
various virtual machine components. The format of the 
DUMP command is: 



DUmp 



hexlod 
Lhexlod 
Thexlod 



in te ,oc2 ] 



["dump id] 



{.} 



[bytecount 
END 



Where: 



hexlod 
Lhexlod 
Thexlod 

is the first or only hexadecimal storage location 

in the virtual machine that is to be dumped. If 

L or no letter prefix is specified, the storage 

contents are dumped in hexadecimal. If T is 

specified, the storage contents are dumped 

along with the EBCDIC translation. 

If hexlocl is not on a boundary divisible by 32, 
it is rounded down to the next lower such 
boundary. 

If L or T is specified without any operand, or 
followed immediately by a blank, the contents 
of all storage is dumped. 

The address may be from 1 to 6 hexadecimal 
digits; leading zeros are optional. 
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- hexloc2 
: END 

is the last of a range of hexadecimal storage 
locations in the virtual machine to be dumped. 
If - or : is the first character of the operand, 
then hexlocl defaults to zero. If hexloc2 is not 
specified, storage is dumped from hexlocl to the 
end of virtual storage. If specified, hexloc2 
must be greater than hexlocl and within the 
virtual storage size. 

The address may be from 1 to 6 hexadecimal 
digits; leading zeros are optional. 

{.} bytecount 
END 

is the hexadecimal integer designating the 
number of bytes of storage to be dumped. The 
sum of hexlocl and bytecount must be an 
address that does not exceed the size of the 
virtual machine. If this address is not on a 
fullword boundary, it is rounded up to the next 
highest fullword. 

The value may be from 1 to 6 hexadecimal 
digits; leading zeros are optional. 

*dumpid 

can be entered for descriptive purposes, and 
must include the asterisk (*) prefix. If 
specified, the dumpid is placed on the first 
output line. 

Usage Notes: 

1 . This command displays only second-level storage 
(storage which is real to the virtual machine). 

2. The CP DUMP command executes in an area of 
storage separate from your virtual machine and 
does not destroy any portion of your storage. 
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3. Use #CP DUMP or press PA1 before entering the 
command to preserve the virtual machine's 
registers. Otherwise, the registers will be those of 
the VM/PC CMS command processor. 

4. The DUMP command dumps the virtual PSW and 
registers. If only this information is required, at \ 
least 1 virtual address must be specified, such as: 

DUMP 

5. The CLOSE command must be issued to create the 
spool file. 

6. To terminate the dump prematurely, press the PA1 
key. 

Responses: 

DUMPING LOC hexloc 

where hexloc is a 64K boundary address (for 
example, 020000, 030000, ...). 

DUMP COMPLETE ( 

indicates normal completion of the DUMP 
command. 
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EXTERNAL 



Use the EXTERNAL command to simulate an external 
interrupt to the virtual machine and return control to 
that machine. 

The format of the EXTERNAL command is: 



EXTernal 




"code" 
.40 . 





Where: 

code 

ko 

is the interrupt code, a hexadecimal number to 
be associated with the external interrupt. All 
codes within the range X'OT through X'FF' are 
valid. The default is the external interrupt 
button on the system console, X'40\ 

Usage Note: This simulates pressing the interrupt key 
on the real computer console, or other functions whi' r 
cause an external interrupt. Control is given to the 
virtual machine immediately. 
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IPL 



Use the IPL command to perform the initial program 
load function for the virtual machine. The format of 
the IPL command is: 



Ipl CMS [parm string] 



Where: 

parm string 

passes a parameter string to VM/PC CMS in 
the virtual machine's general registers. The 
string is padded on the right with blanks to 
make 64 bytes (which fills the 16 registers). If 
parm string is not specified, the general registers 
are cleared to zeros. 

Usage Notes: 

1 . The IPL command will always clear virtual storage 
to zeros before performing the program load. 

2. See the section "CMS Initialization" in Appendix 
B, "Comparison of VM/PC and VM/SP" on 
page B-l for more information. 

3. If an automatic environment IPL is performed 
(either from the logon screen or the configuration 
file), the string 'AUTOIPL' will be loaded. 
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LINK 



Use the LINK command to request access to a minidisk 
defined in another user's configuration. The format of 
the LINK command is: 



LINK [To] userid dvcadrl [As] dvcadr2 [mode] 
[[PASS=] password] [LOCAL 1 

Lremotej 



Where: 

user id 

is the name of the user whose configuration is to 
be searched for minidisk dvcadrl. Use * to 
indicate that your own userid is to be used. 

If the keyword TO is omitted, the userid may 
not be T or TO. 

dvcadr 1 

the device address searched for in the 
configuration for userid. 

[AS] dvcadr2 

is the device address to be temporarily added to 
your virtual machine configuration. 

If the keyword AS is omitted, dvcadr2 may not 
be A or AS. 

mode 

is the access mode. Valid access modes are: 

Mode Meaning 

R Read-only (R/O) access. If the link is 

REMOTE, the link is not done if any other user 
has write access. 
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RR Read-only (R/O) access. If the link is 

REMOTE, the link is established even if any 
other user has write access. 

W Write access. If the link is REMOTE, the link is 
not done if the mini-disk is accessed by any other 
user in either read or write mode. 

WR Write access with acceptable reduction to read 
access. If the link is REMOTE, a write access 
will be established unless any other user has either 
read or write access; in this case, read access will 
be established. 

M Write access. If the link is REMOTE, the link is 
not done if the mini-disk is accessed by any other 
user in write mode. 

MR Write access with acceptable reduction to read 
access. If the link is REMOTE, a write access 
will be established unless any other user has write 
access; in this case, read access will be 
established. 

MW Write access. If the link is REMOTE, write 

access will be established regardless of any other 
user access. 

Caution: More than one user writing to the same virtual 
device can result in permanent loss of data. 

If the mode is omitted, the default is R if the userid is 
for another user. If you are linking to one of your own 
disks, the default mode is the one defined in your 
configuration. 

[PASS=] password 

is the one to eight character string that must 
match the access mode password for the 
dvcadrl specified (this should not be confused 
with your user password). 
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LOCAL 

the LINK is to be resolved in the local system 
configuration file. 

REMOTE 

the LINK is to be resolved in the host system 
directory. 

Usage Notes: 

1. If you link to one of your own minidisks, the 
password is not required. 

2. If REMOTE is specified, the Host Server must be 
active for the link to be established. 

3. If neither LOCAL nor REMOTE is specified, the 
local configuration file is searched. If the link is not 
resolved locally and the Host Server utility is active, 
the link resolution will be attempted at the host 
system. 

4. You can only link to a minidisk once. If you link to 
a minidisk and then try to link to the same minidisk 
as another address (cuu), you will recive a message 
telling you the minidisk is already linked. 

Responses: 

ENTER READ PASSWORD: 

enter the read password to obtain read access. 

ENTER WRITE PASSWORD: 

enter the write password to obtain write access. 

DEV dvcadr2 LINKED 

indicates that access has been established to the 
requested minidisk. This response will not 
appear if you have issued the CP SET IMSG 
OFF command. 
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LOGOFF 



Use the LOGOFF command to terminate the current 
session. The format of the LOGOFF command is: 



LOGoff 
LOGout 



Usage Notes: 

1. This command closes any active spool files, and 
relinquishes access to any temporary minidisks. 

Response: 

The VM/PC logo reappears on the display when 
the logoff is complete allowing another logon to be 
performed. 
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ORDER 



Use the ORDER command to place your spool files in a 
specific order. The format of the ORDER command is: 



ORDer 



J Printer/ spool id1 spool id2 
/PRT S 



Where: 

PRINTER 
PRT 

places printer files in the specified order. 

spool idl spool id2 ... 

are the spoolids of the files to be rearranged and 
the order in which they are to be placed. 

Usage Notes: 

1 . Spool files selected by the ORDER command will 
be placed in the specified order ahead of those files 
not selected. The files not selected will remain in 
their same relative order. 

2. When issued from the local session, the ORDER 
command only applies to files on the local spool 
queue. You must issue the VM/SP ORDER 
command in the host session to order files that are 
on the host spool queue. 



Response: 



nnnn FILE(S) ORDERED 

This response indicates the number of files 
ordered; if none are ordered nnnn will be NO. 
This response will not appear if you have issued 
the CP SET IMSG OFF command. 
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PURGE 



Use the PURGE command to erase your spool files 
before they are selected for processing, or to terminate 
processing of an active file. The format of the PURGE 
command is: 



PURge 



Printer} (spoolicM spoolid2 
PRT S 1ALL 

(ACTive [HOId] 



Where: 

PRINTER 
PRT 

purges printer files. 

spool id1 spool id2 ... 

are the spoolids of the files to be purged. 

ALL 

purges all files for the type specified. 

ACTIVE [HOLD] 

purges the file currently being processed for the 
type specified. The HOLD option terminates 
processing of the file but does not erase the file; 
the file is retained and is placed in HOLD 
status. 

Usage Note: 

1. When issued from a local session, the PURGE 
command only applies to files on the local spool 
queue. You must issue the VM/SP PURGE 
command from the host session to purge files that 
are on the host spool queues. 
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Response: 



nnnn FILE(S) PURGED 

This response indicates the number of files 
purged; if none are purged nnnn will be NO. 
This response will not appear if you have issued 
the CP SET IMSG OFF command. 
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QUERY 



Use the QUERY command to inquire about the 
following information: 

• The time of day. 

• Attributes of closed spool files not currently being 
printed. 

• The current values of SET functions. 

• The current values of TERMINAL functions. 

• The spool attributes of the printer. 

• The current setting of program function keys. 

The format of the QUERY command is: 



Query 


< 


f USERID \ 
CPLEVEL 
Time 
SET 

TERMinal 
PF nn 
UR 

STORage I 
CONSole f 
DAsd 
dvcadr 

{VIRTUAL [ALL]} 

(Printer* fNOHoldl 
, JPRT J [spool id] LHOld J [ALL] [TBL] / 



Where: 



USERID 

displays the userid of the active user. 

CPLEVEL 

displays the VM/PC CP service level. 



TIME 



displays the current time and date. These values 
depend on the time and date that reside in DOS 
and may have been set prior to entering the 
S/370 environment. 
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SET 

displays the status of the SET command 
options. 

TERMINAL 

displays the status of the TERMINAL 
command options. 

PF[nn] 

displays the operand of the specified program 
function key. The value of nn may be from 1 to 
12. If nn is not specified, all function operands 
are displayed. 

UR 

displays the status of the console and printer. 

STORAGE 

displays the size of your virtual storage. 

CONSOLE 

displays the status of the console. 

DASD 

displays the status of all of the minidisks 
currently in the virtual machine configuration. 

dvcadr 

displays the status of the device dvcadr. 

VIRTUAL 

displays all storage, all unit record devices, and 
all DASD attached to the user's userid. Note 
that the optional operand ALL does the same 
thing. 

PRINTER 
PRT 

displays an information line for each spool file 
not currently being printed. 

spool id 

selects spool information for a specific file on 
the local spool queue. 
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NOHOLD 

selects spool information for all files that are 
not in HOLD status. 

HOLD 

selects spool information for all files that are in 
HOLD status. 

ALL 

displays additional information for spool files. 

TBL 

displays additional information about spool file 
created for the 3800 printer. 

Responses: 

Query Userid 

user i d 

Query CPLEVEL 

VM/PC, VERSION n.nn, SERVICE LEVEL nnn 

Query Time 

TIME IS hh:mm:ss ON weekday mm/dd/yy 

The current time and date are displayed based 
on the values set when DOS was loaded. 

Query Set 

(ON ) 

Jon \ \m \ )off \ <on { 

run joffj, linedit ?0ff\, emsg u0de(\ imsg jofff 

Itext; 
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Query Terminal 

LINEND /OFF}, LINEDEL / OFF}, CHARDEL /OFF), ESCAPE j OFF i 

(ON ) \ FULL> ( VM> ION ) i ON ) 

HI LIGHT J OFF), PA2/HALF), MODE ( CP ), WRAP/OFF), APL ( OFF ) 

Query PF[nn] 

(IMMED ) 
PFnn ) DELAYED \ [pf data1# . . . 1 
) RETRIEVE ( 

(undefined; 

Query UR 

See responses for CONSole and Printer. 

Query Storage 

STORAGE=nnnnK 

Query CONSole 

CONSOLE 01F 

Query DASD 

5 FB-512 drive) \R) I" ~| Tuserid dvcadr2~| 
DASD dvcadr ( REMOTE ) (U) |_nnnnn BLK J [_**TEMP** J 

This information line is displayed for each 
minidisk in your virtual machine configuration. 

Where: 

dvcadr 

is the address of the minidisk. 

FB-512 

indicates that the mini-disk resides locally. 

REMOTE 

indicates that the mini-disk resides on the host 
system. 
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dr ive 

is the Personal Computer disk/diskette drive on 
which the mini-disk resides. 

R 
W 

indicates the read/write status of the minidisk. 

nnnnn 

is the number of blocks allocated to the 
minidisk. 

userid dvcadr2 

indicates the userid and device address linked 
to. 

""TEMP"" 

indicates that this is a temporary disk. 

Query dvcadr 

PRT dvcadr CL c contatr holdatr COPY nnn READY FORM form 

dvcadr TOlFOR userid D I ST distcode FLASHC ccc LINECT 111 sepatr 
dvcadr FLASH ovly CHAR ctab ctab ctab ctab MDFY cmod FCB pcpi 

Where: 

c 

is the spool class. 

contatr 

is the continuation attribute, CONT or 
NOCONT. 

holdatr 

is the hold attribute, HOLD or NOHOLD. 

nnn 

is the number of copies to be produced. 

form 

is the form type to be used when the file is 
printed. 
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distcode 

is the distribution code 

ccc 

is the number of copies to be superimposed with 
the overlay frame. 

Ill 

is the number of lines per page. 

sepatr 

is the separator page attribute, SEP or NOSEP. 

ovly 

is the name of the forms overlay frame to be 
used. 

ctab 

is the name of the character arrangement table 
to be used. 

cmod 

is the name of the copy modification module to 
be used on output text. 

pcpi 

is the name of the FCB module to be used in 
the vertical formatting of a page. 

CONSOLE dvcadr 

for keyboard/display 

see Query Dasd for minidisk format. 
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Query Printer: 



ORIGIN ID FILE CLASS RECORDS CPY HOLD FORM 
userid id a typ norecs nnn stat form 

ORIGIN ID FILE CLASS RECORDS CPY HOLD DATE TIME NAME TYPE D I ST 
userid id a typ norecs nnn stat mm/dd hh:mm:ss name type dist 

ORIGIN ID FILE CLASS RECORDS CPY HOLD FLASH CHARS FCB MDFY FLSHC 
userid id a typ norecs nnn stat ovly ctab plpi cmod ccc 
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REQUEST 



Use the REQUEST command to make an attention 
interrupt pending at your virtual console. The format of 
the REQUEST command is: 



REQuest 



Usage Notes: 

1 . The REQUEST command performs the same 
functions as ATTN and the two commands can be 
used interchangeably. 

2. CP ignores the REQUEST command if any I/O 
operation is in progress at the console or if other 
interrupts are pending. This condition may result if 
the user issues the REQUEST command by means 
of DIAGNOSE X'8\ 
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SET 



Use the SET command to control various functions of 
your virtual machine. The format of the SET command 
is: 



SET 




( IMSG 
L 1 NED! 

RUN 


i 0N I \ 

t Ioffs 






< 


EMSG 


\ CODE ( 

I text; 


► 






PFnn 


~IMMed pfdata1#... 

DELayed [ICc] [BLb] pfdata1#... 
_RETrieve 








V 


/ 



Where: 



IMSG 



ON l 
OFF? 



controls whether certain informational messages 
issued by the CP CHANGE, CLOSE, 
DEFINE, DETACH, ORDER, PURGE and 
SPOOL commands are displayed or not. The 
descriptions of the CP commands tell which 
messages are affected. If ON is specified, the 
messages are displayed; if OFF, they are not. 
When you log on, IMSG is set ON. 

I NED IT j ON I 

/OFF* 

controls whether line editing is active or not. 
ON specifies that keyboard input is to be 
scanned for line editing characters; OFF, that 
no line editing is to be performed. When you 
log on, LINEDIT is set ON. 
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RUN JON l 
(OFF) 

controls the termination of the CP command 
environment. ON specifies that the CP 
command environment automatically ends after 
the execution of the CP command entered; 
OFF specifies that the CP command 
environment continues until terminated with the 
BEGIN command. 

emsg (on ) 

OFF \ 
CODE ( 

:text) 

controls error message handling. ON specifies 
that both error code and text are to be 
displayed; TEXT, that only the text is to be 
displayed; CODE, that only the code is to be 
displayed; OFF that no error messages are to be 
displayed. When you log on, EMSG is set 
TEXT. 

PFnn flMMED pfdata1#... 1 

[DELAYED [ICc] [BLb] pfdata1#. . J 

defines the function to be performed for the 

specified program function key. If specified 

with no operand, the key will be considered to 

be undefined. 

In PFnn, nn is a number from 1 to 12 that 
corresponds to a key on the keyboard. The 
operand defines the function(s) to be performed 
when you press that key. 

IMMED indicates that the function(s) is(are) to 
be performed immediately after pressing the 
key. DELAYED indicates that the pfdata#... is 
to be written into the display input area, and 
will not be executed until you press the ENTER 
key. If neither is specified, DELAYED will be 
assumed. 

ICc defines the character c which will be 
replaced with an insert cursor control character; 
only the first occurrence of c will be replaced. 
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If ICc is not specified with the DELAYED 
option, the cursor will be placed at the end of 
the data. 

BLb defines the character b which will be 
replaced by blanks; all occurrences of b will be 
replaced by blanks. 

pfdata1#. . . 

defines the command(s) that constitute the 
function to be performed. If more than one 
command is to be executed, the commands must 
be separated by a logical line-end character 
(defaults to #). 

Note: When setting a PF key from the command 
line, if you use the logical line-end character you 
must precede it with the terminal escape character. 
The default character for line-end is a pound sign 
(#) and for terminal escape is a double quote ("). 
Use the QUERY SET command to see your 
character settings and use the TERMINAL 
command if you wish to change them. 

PFnn RETRIEVE 

specifies that input data is to be retrieved from 
the terminal activity history buffer when the 
function key is pressed. 

In PFnn, nn is a number from 1 to 12 that 
corresponds to a function key on the keyboard. 

If the cursor is located in the input area of the 
screen when the function key is pressed, the 
previously entered input is written into the input 
area on the screen. If the function key is 
pressed again, without pressing the ENTER 
key, the input previous to that just placed into 
the input area is written into the input area. 
When the least recent input data available in the 
activity history buffer is in the input area, 
pressing the function key will cause the most 
recent input data to be displayed again. 
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If the cursor is located on a line displaying 
previously entered input when the function key 
is pressed, that input is written into the input 
area (previously entered input may be displayed 
by scrolling). Then, leaving the cursor in the 
input area and pressing the function key, the 
input previous to the one just written to the 
input area will be displayed. 

Usage Notes: 

1. The ICc and BLb options for PFnn are intended to 
be used when the command is executed via 
Diagnose 8 (for example, from a VM/PC CMS 
EXEC). 

2. For the RETRIEVE function, the amount of input 
contained in the activity history buffer depends on 
the amount of both input and output (however, it 
will generally be the case that large amounts of 
output to the display will be the factor limiting the 
number of input lines remaining in the buffer). 
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SPOOL 



Use the SPOOL command to alter the attributes that a 
spool file will be given when it is closed. You can direct 
spool files to remote locations by using the SPOOL 
command in conjunction with the TAG command. The 
format of the SPOOL command is: 



SPool 


(Printer) 
PRT 
(dvcadr ) 


" [Tol JuseridJ [HOld "1 [CONt 1 
LForJ / * ) LNOHoldJ LNOContJ 

OFF 










CLass c] 

COpy nnn [LINect nnn] 

FLash name nnn] [MOdify name] 

CHars name] [FCB name] 








[FORM \ form f] [SEP 1 
L ( OFF U LNOSepJ 








|"Dist \ distcode H 








PURge 








_CL0se 





Where: 



PRINTER 
PRT 

modifies attributes for the printer spool file. 

dvcadr 

modifies attributes for printer device. 

TO userid 

specifies the userid to receive the spool file. 
This option can only be specified if CLASS is 
not *. 
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FOR ujerid 

specifies the userid under which the spool file is 
to be created. The userid becomes the owner of 
the spool file. This option can only be specified 
if CLASS is not *. 

HOLD 

places the spool file in hold status when the file 
is closed. This means that the system cannot 
select the file for processing until it is released 
by issuing a CHANGE command for the file. If 
HOLD is specified, NOHOLD may not be 
specified. 

NOHOLD 

indicates that a spool file will be selectable for 
immediate processing when it is closed. If 
NOHOLD is specified, HOLD may not be 
specified. 

CONT 

indicates that continuous spooling is to be 
performed (CLOSE command requests are to 
be ignored). If CONT is specified, NOCONT 
may not be specified. 

NOCONT 

indicates that continuous spooling is to be reset. 
If NOCONT is specified, CONT may not be 
specified. 

COPY nnn 

specifies the number of copies to be processed 
when the spool file is closed. 

LINECT nnn 

specifies the number of lines per page on the 
output form. VM/PC CP uses this to format 
pages for the DUMP and TRACE commands. 

CLASS c 

specifies the spool class for the device. If the 
value of c is A-Z or 0-9, the spool file will be 
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routed to the Host Server. If the value of c is *, 
the spool file will be routed to the local printer. 

FLASH name nnn 

signifies that a forms overlay contained in the 
3800 printer is to be superimposed onto the 
output. The name, one to four characters, 
identifies the overlay to be used. The number, 
nnn, specifies the first nnn copies are to 
superimposed; the remaining copies made will 
remain unflashed. If nnn is specified as 0, the 
default, no superimposing will be done. 

MODIFY name 

assigns a copy modification module to be used 
when printing a file on the 3800. This function 
makes it possible to alter the text by either 
preventing printing of certain information or by 
adding labels to the output. The name must be 
one to four characters; if omitted, the file will 
print without modification. 

CHARS name 

specifies the name of the character arrangement 
table to be used when printing the file; the 
name must be one to four characters. 

FCB name 

controls the vertical spacing of the output on a 
page; the name must be one to four characters. 

FORM form 
OFF 

specifies the form name for spool files when 

they are closed. The form must be one to eight 

characters. OFF indicates that the default is to 

be used. 

SEP 

puts separator page prior to spool file. 

NOSep 

does not put a separator page prior to spool file. 
This is the default. 
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DIST distcode 
OFF 

specifies the distribution code the spool file is to 

have when it is closed. OFF indicates that the 

default is to be used. 

OFF 

performs the same function as 'CLASS *\ 

CLOSE 

closes the spool file regardless of the CONT 
setting. CLOSE does not affect the setting of 
any spool attributes. If CLOSE is specified, 
PURGE may not be specified. 

PURGE 

closes and purges the spool file regardless of the 
CONT setting. PURGE does not affect the 
setting of any spool attributes. If PURGE is 
specified, CLOSE may not be specified. 

Usage Notes: 

1 . The destination commit point occurs at the time the 
spool file is opened. This means that when the first 
line of a spool file is received and the file is opened, 
the destination (local or remote) is fixed for that 
file. If a SPOOL command is issued altering the 
destination and a spool file is open, it will be closed 
prior to the destination change taking effect. 

2. Output classes are not supported for the local 
printer because the local output priority and forms 
selection can be performed with the HOLD option. 

3. Local printing will be performed using the 132 
characters/line font unless the 'CHARS 80' option 
has been specified to indicate that the 80 
character/line font is to be used. 

4. EXECs running in VM/PC CMS can stack the 
spool characteristics via "Query dvcadr" and parse 
out the LINECT operand. This allows lines/page 
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to be controlled at a single point, the SPOOL 
command. 



Response: 



Same as CLOSE command if the CLOSE option is 
used to close a spool file (see "CLOSE" on 
page 7-18). 
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STORE 



Use the STORE command to alter the contents of 
registers and storage of the virtual machine. The 
format of the STORE command is: 



STore 




/ hexloc 
Lhexloc 

Shexloc 


hexwordl [hexword2 .. 
hexdata. . . 


■ ] 






« 


Greg 


j%[+Xddd] hexdata... 
/hexwordl [hexword2 . 


• ] 


► 






Yreg 


hexdwordl [hexdword2 


... ] 








k Psw 


[hexwordl] hexword2 


> 





Where: 



hexloc 
Lhexloc 



hexwordl [hexword2 ... ] 
stores the specified data in successive fullword 
locations starting at the fullword specified by 
hexloc. The smallest unit that can be stored is a 
fullword. 



If hexloc is not on a fullword boundary, it is 
rounded down to the next lower fullword. If the 
value of an operand contains less than a 
fullword (8 hexadecimal digits), it is 
right-adjusted in the word and padded on the 
left (high-order digits) with zeros before it is 
stored. 

Shexloc hexdata. . . 

stores data at the address specified by hexloc 
without word alignment. The smallest unit that 
can be stored is one byte (2 hexadecimal digits). 
If an odd number of hexadecimal digits is 
specified, none of the data is stored, and an 
error message is generated. 
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Greg %[+Xddd] hexdata... 

stores data at the address specified by in reg, 
plus the optional displacement ddd, without 
word alignment. The smallest unit that can be 
stored is one byte (2 hexadecimal digits). If an 
odd number of hexadecimal digits is specified, 
none of the data is stored, and an error message 
is generated. 

Greg hexwordl [hexword2 ...] 

stores the specified data in successive general 
registers starting at the register specified by reg. 
The reg operand must be a decimal value from 
to 15 or a hexadecimal digit from to F If the 
value of an operand contains less than a 
fullword (8 hexadecimal digits), it is 
right-adjusted in the word and padded on the 
left (high-order digits) with zeros before it is 
stored. 

Yreg hexdwordl [hexdword2 ...] 

stores the specified data in successive 
floating-point registers starting at the register 
specified by reg= The reg operand must be an 
integer with one of the following values: 0, 2, 4, 
or 6. If the value of an operand contains less 
than a double word (16 hexadecimal digits), it is 
left-adjusted in the doubleword and padded on 
the right (low-order digits) with zeros before it 
is stored. 

PSW [hexwordl] hexword2 

stores the specified data into the first and 
second words of the virtual machine PSW. If 
only hexword2 is specified, it is stored into the 
second word of the PSW. If either value, 
hexwordl or hexword2, is less than a fullword 
(8 hexadecimal digits), it is right-adjusted and 
padded on the left (high-order digits) with zeros 
before it is stored. 
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Usage Notes: 

1 . This command stores into only second-level storage 
(storage which is real to the virtual machine). 

2. Multiple operands on a single command line will not 
be supported. 

Response: 

STORE COMPLETE 



Chapter 7. VM/PC Commands 7-6 1 



TAG 



Use the TAG command to associate remote routing 
information with a spool file when it is spooled to the 
Host Server. The format of the TAG command is: 



TAg 



DEv ( Pr inter 
PRT 
dvcadr 



tagtext 



(JUery DEv ( Printer 
PRT 
dvcadr 



Where: 



DEV (PRINTER) 
JPRT \ 

(dvcadr ) 

specifies that the printer output is to have the 

tag information associated with it or that the 

printer tag information is to be queried. 

tagtext 

specifies the tag information. It can be up to 
134 characters including imbedded blanks. The 
contents of the tagtext depends on the 
requirements of the transmission network; it is 
user's responsibility that the addressing and 
control information is meaningful. 

QUERY DEV ( PRINTER] 
\ PRT 
( dvcadr 

displays the tag information associated with the 

printer. 



Usage Notes: 

1 . If the tagtext is not specified, the tag information 
area is cleared. 

2. When the printer is spooled CLASS *, the tag 
information is ignored. 
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Responses: 

PRT dvcadr TAG: 
tagtext . . . 

The tagtext is displayed in response to a query 

for the printer and the tag has been set. 

PRT dvcadr TAG NOT SET 

is displayed in response to a query for the 
printer and the tag has not been set. 
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TERMINAL 



Use the TERMINAL command to control various 
functions of the keyboard/display. The format of the 
TERMINAL command is: 



TERMinal 

4 


i CHardel I ON / ' 
LINEDel ^OFF \ 
LINENd (char) 
EScape 

Hllight JON l 
/ OFF S 

PA2 S FULL I 
( HALF ) 

MODE JCP } 
<VM ) 

WRAP JON ( 
<0FF\ 

APL JON I 
/OFF* 


► 



Where: 



CHARDEL 



CN 

CFF 

char 



defines the logical character delete symbol. If 
ON is specified, the default symbol (@) 
becomes the delete symbol. If OFF is specified, 
no logical character delete editing is done. If 
char is specified, that character becomes the 
logical character delete symbol; the character 
chosen should not be common to the normal 
data stream being entered. When you log on, 
CHARDEL ON is in effect. 
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LINEDEL \ ON 
OFF 
char] 

defines the logical line delete symbol. If ON is 

specified, the default symbol (0) becomes the 

delete symbol. If OFF is specified, no logical 

line delete editing is done. If char is specified, 

that character becomes the logical line delete 

symbol; the character chosen should not be 

common to the normal data stream being 

entered. When you log on, LINEDEL ON is in 

effect. 

LINEND { ON 
OFF 
char 

defines the logical line end symbol. If ON is 

specified, the default symbol (#) becomes the 

logical line end symbol. If OFF is specified, no 

logical line end editing is done. If char is 

specified, that character becomes the logical line 

end symbol; the character chosen should not be 

common to the normal data stream being 

entered. When you log on, LINEND ON is in 

effect. 

ESCAPE (ON 
< OFF 
f char ' 

defines the logical escape symbol. If ON is 

specified, the default symbol (") becomes the 

logical escape symbol. If OFF is specified, no 

logical escape editing is done. If char is 

specified, that character becomes the logical 

escape symbol; the character chosen should not 

be common to the normal data stream being 

entered. When you log on, ESCAPE ON is in 

effect. 

HILIGHT JON I 
(OFF) 
when HILIGHT is set ON, input from the 
keyboard is high-lighted on the display; when 
set OFF, input is displayed at normal intensity. 
When you log on, HILIGHT OFF is in effect. 
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PA2 S FULL/ 
/ HALF? 

defines the amount that the activity screen is 

scrolled when the PA2 key is pressed with the 

cursor in the input area. If FULL is specified, 

the entire screen is cleared when the PA2 key is 

information on the lower half of the activity 
screen, the normal action of clearing the screen 
is performed; if there is information on the 
lower half of the activity screen, the line in the 
middle of the output area is scrolled to the top 
of the output area on the screen. 

For both the FULL and HALF options, when 
the PA2 key is pressed, if the Cursor resides on 
one of the lines in the output area, that line is 
scrolled to the top of the output area. 

In all cases, all lines removed from the screen 
are scrolled into the terminal activity history 
buffer. 

When you log on, PA2 FULL is in effect. 

MODE ( VM \ 

controls the terminal attention environment. 
CP specifies that all attentions are to be handled 
by VM/PC CP. VM specifies that the first 
attention is to be reflected to the virtual 
machine; following attentions, prior to the 
virtual machine performing a VM READ, will 
the handled by VM/PC CP. When you log on, 
MODE VM is in effect. 

WRAP JON I 
J OFF J 
controls the display of information lines longer 
than the width of the screen. 

ON specifies that more than 1 screen line is to 
be used to display the entire information line 
(information will wrap from one screen line to 
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the next). An attempt will be made to split the 
information at an appropriate break-point so 
that words will not span 2 screen lines. 
Specifying ON also disables the scrolling 
commands for windowing the screen left and 
right. 

OFF specifies that an information line is to take 
only 1 screen line and information beyond the 
width of the screen must be displayed with the 
left and right windowing command in the scroll 
area. If an information line is longer than a 
screen line, an ellipsis (...) will be displayed on 
the right-hand portion of the screen to indicate 
that more information is there. 

When you log on, WRAP ON is in effect. 

APL JON { 
(OFF? 

is provided for command compatibility only; the 

APL character set is not available. 

ON enables the Diagnose 54 alteration of the 
PA2 key function from screen clear to external 
interrupt. 

OFF restores normal PA2 key screen clear 
functions. 

When you log on, APL OFF is in effect. 

Usage Notes: 

1 . The terminal settings you specify are only in effect 
for the duration of the session. 

2. Although you can define line-editing symbols, the 
LINEDIT operand of the SET command determines 
whether line-editing functions will be performed or 
not. 
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Only one operand at a time may be specified on the 
TERMINAL command. 

You cannot use any of the letters A-Z, or numbers 
0-9 as the char in the CHARDEL, LINEDEL, 
LINEND, and ESCAPE operands. 
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TRACE 



Use the TRACE command to trace various virtual 
machine activity on either the display, or printer, or 
both. Tracing can be continuous, RUN option, or 
step-by-step, NORUN option. 

If you issue more than one TRACE command, the 
operands are generally cumulative; refer to the Usage 
Notes for limitations. In addition, the RUN and 
NORUN operands can be specified with different 
TRACE functions and do not cause conflict. 

Note: If you issue conflicting operands with the same 
TRACE command (for example, RUN and NORUN), 
VM/PC will accept the last one on the command line, 
and ignore any previous conflicting operands. 

The format of the TRACE command is: 



TRace 



/SVC [nn] 

DIAG [nnn] 
^PRIV [nn] 
/PROgram 



I Instr 
f Store 
BRancK> 



hexlod 



r-hexloc2 "I 
[_.bytecountJ 



(Greg% [+Xddd] [ .bytecount] J 



• END 



END 
Printer 



[CONsolelfNORunl 
BOTH J [RUN J 

_PAss[0|nn] [CMD text] 



Where: 



SVC [nn] 

traces virtual machine SVC interrupts. If nn is 
specified, the SVC whose hexadecimal interrupt 
code is nn is traced. 

DIAG [nnn] 

traces virtual machine diagnose instructions. If 
nnn is specified, the diagnose instruction whose 
hexadecimal function code is nnn is traced. 
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PR I V [nn] 

traces virtual machine privileged instructions. If 
nn is specified, the privileged instruction whose 
hexadecimal operation code is nn is traced. 

PROGRAM 

traces virtual machine program interrupts. 

INSTR 

indicates that address comparison is be 
performed on storage accesses for instruction 
fetch. 

STORE 

indicates that address comparison is be 
performed on accesses which cause virtual 
storage to be altered. 

BRANCH 

traces virtual machine interrupts, PSW 
instructions, and successful branches. 

hexlod 

is the first or only hexadecimal storage location 
in the virtual machine where execution is to be 
halted. 

-hexloc2 

is the last storage location defining a range of 
virtual addresses to be used for comparison. If 
an address compare occurs, including on 
hexloc2, execution is halted. 

Greg% [+Xddd 

the first, or only, virtual address at which to halt 
execution is the address contained in reg, plus 
the optional displacement ddd. 

. bytecount 

is a hexadecimal value of the number of bytes to 
be included within a range of virtual addresses 
to be used for comparison; the sum of hexlocl 
plus bytecount determines the first address that 
is beyond the range. If an address compare 
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occurs within the range of addresses execution 
is halted. 

END 

terminates the specified or all tracing activity. 

PRINTER 

directs tracing output to the printer. The 
destination of the output depends on the 
SPOOL and TAG values currently set. 

CONSOLE 

directs tracing output to the display. 

BOTH 

directs tracing output to both the printer and 
display. 

NORUN 

halts program execution after the trace output is 
displayed and enters the VM/PC CP command 
environment. 

RUN 

continues program execution after the trace 
output has been displayed. 

PASS [nn] 

suppresses the display of nn successful events 
between displays (nn must be between and 
32767). PAss 1 causes every other event to be 
traced. PAss nn turns on trace for the nn 
occurence of that event. PAss is the default if 
specified without nn. PAss turns off the 
option and always traces. 

CMD text 

specifies a CP command or commands to be 
executed when the given event occurs. If the 
CMD option is used, it must be the last option 
on the command line. Everything after the 
CMD keyword is passed as a command to CP. 
Multiple commands may be used if LINEDIT is 
on and the LINEND character is used between 
commands. 
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Usage Notes: 

1. The "Instr," "Store," and "BRanch" functions and 
their operands are not cumulative if multiple 
TRACE commands are issued. Only the most 
recently specified function will be traced in such an 4 
event. For example, it is not possible to trace ^ 
(simultaneously) two ranges of instructions, or to 
trace a storage alteration and a range of successful 
branches. 

2. A table of 16 specific codes for each of SVC, 
DIAG, and PRIV operands is kept. When the 
operand is specified without the nn option, the table 
is cleared and all interrupts or instructions are 
traced for that operand. The codes specified in 
these operands are cumulative until the respective 
table is full; an entry may not be deleted from the 
table, but the table's contents can be cleared by 
re-specifying the operand without the nn option. 

3. To resume operation of the virtual machine after 
instruction execution has been halted with the ( 
NORUN option, the BEGIN command must be 
entered. 

4. The TRACE command can be used as an address 
stop function by using the NORUN option. 

5. Instruction fetch traces of a single address may 
cause unexpected results if the address being traced 
is used as a data area. Tracing a two-byte range 
will avoid this situation, and will yield the same 
results. 

6. Stores to a location which do not cause the storage 
to change will not be detected by storage alteration 
trace. 

7. Storage alteration trace is limited to any four (4) 
consecutive bytes of storage. 
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8. If trace output is being recorded on the printer, a 
CLOSE command must be entered to create the 
spool file. 

9. When recording trace output on the printer, the 
trace output is intermixed with other data sent to 
the printer. 

Responses: The following symbols are used in the 
responses received from TRACE: 

mnem mnemonic for the instruction 

i i i i i i i i instruction (2, 4, or 6 bytes) 

bm branch mask 

cc condition code 

code interrupt code 

TRACE ACTIVATED 

tracing function activated 

TRACE TERMINATED 

tracing function terminated 

INSTR FETCH AT xxxxxx mnem iiiiiiii CC=cc 
The instruction at virtual storage location 
xxxxxx satisfied the instruction fetch 
comparison and sequential processing 
continues. 

INSTR FETCH AT xxxxxx mnem iiiiiiii ===> 

yyyyyy 

The instruction at virtual storage location 
xxxxxx satisfied the instruction fetch 
comparison, and the next instruction will be 
fetched from storage location yyyyyy. 

STG ALTER AT xxxxxx BY INSTR AT yyyyyy mnem 
iiiiiiii CC=cc 

The instruction at virtual storage location 

yyyyyy satisfied the storage alteration 

comparison at xxxxxx. 
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PROG I NTERRUPT code AT xxxxxx mnem i i i i i i i i 

===> yyyyyy 

A program interrupt occurred at location 
xxxxxx and the resulting PSW swap will fetch 
the instruction at yyyyyy. 

SVC INTERRUPT code AT xxxxxx menm iiiiiiii 

===> yyyyyy 

A supervisor call interrupt occurred at location 
xxxxxx and the resulting PSW swap will fetch 
the instruction at yyyyyy. 
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CMS Commands 



The CMS command language allows you to create, 
modify, debug, and, in general, manipulate a collection 
of files. 



Character Set Usage 



You can enter CMS commands using a combination of 
characters from six different character sets. The 
following figure shows the contents of the character 
sets. 



Character Set 


Names 


Symbols 


Separator 


Blank 




National 


Dollar Sign 
Pound Sign 
At Sign 


$ 
# 
@ 


Alphabetic 


Uppercase 
Lowercase 


A-Z 

a - z 


Numeric 


Numeric 


0-9 


Alphameric 


National 
Alphabetic 

Numeric 


A-Z 

a - z 
0-9 



Figure 7-2 (Part 1 of 2). Character Sets and Their Contents 
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Character Set 


Names 


Symbols 


Special 




All other 
characters 



Figure 7-2 (Part 2 of 2). Character Sets and Their Contents 



CMS Command Search Order 

When you enter a command line in the CMS 
environment, CMS has to locate the command to 
execute. If you have EXEC or MODULE files on any 
of your accessed disks, CMS treats them as commands; 
also, they are known as user-written commands. 

As soon as the command name is found, the search 
stops and the command is executed. The search order 
is: 

1 . Search for a file with f iletype EXEC on any 
currently accessed disk. CMS uses the standard 
search order (A through Z). 

2. Search for a valid name on any currently accessed 
disk, according to current SYNONYM file 
definitions in effect. 

3. Search for a nucleus extension command if the high 
order byte of register 1 is not equal to X'03' or 
X'04\ 

4. Search for a command in the transient area. 
Commands which may be in the transient area are: 
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ACCESS 


GLOBAL 


SET 


COMPARE 


MODMAP 


SYNONYM 


FILEDEF 


PRINT 


TYPE 


GENDIRT 


RELEASE 





5. Search for a nucleus-resident command. The 
nucleus-resident CMS commands are: 



CP 


GENMOD 


START 


DEBUG 


INCLUDE 


STATE 


ERASE 


LOAD 


STATEW 


ESTATE 
ESTATEW 


LOADMOD 
NUCXLOAD 





6. Search for a file with file type MODULE on any 
currently accessed disk. 

7. Search for a valid abbreviation or truncation of a 
nucleus extension. 

8. Search for a valid abbreviation or truncation of a 
command in the transient area. 

9. Search for a valid abbreviation or truncation of a 
command in the nucleus. 

10. Search for a valid abbreviation or truncation of any 
other CMS command 

1 1 . Search for a CP command. 

12. Search for a valid abbreviation or truncation of a 
CP command. 

For example, if you create a command module that has 
the same name as a CMS nucleus-resident command, 
your command module cannot be executed, since CMS 
locates the nucleus-resident command first, and 
executes it. When a user-written command has the 
same name as a CMS command module abbreviation, 
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certain error messages may indicate the CMS command 
name, rather than the program name. 

You can enter CMS commands when you are running 
CMS in your virtual machine, the terminal is idle, and 
the virtual machine can accept input. 

When CMS is processing a previously entered 
command, the keyboard remains unlocked for 
additional command input. Note that in these 
circumstances the command you enter is stacked in the 
terminal input buffer and is not executed until the 
command that is currently being executed completes. If 
more commands are entered than CP can handle, a 
NOT ACCEPTED message is displayed at the display 
terminal. 

In addition to the commands listed in the figures that 
follow, there are six commands called Immediate 
commands that are handled in a different manner from 
the others. They may be entered while another 
command is being executed, and they are executed 
immediately. The Immediate commands are: 

• HI - Halt interpretation 

• HT - Halt typing 

• HX - Halt execution 

• RT - Resume typing 

• TE - Trace end 

• TS - Trace start 
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Summary of CMS Commands 



Command 


Usage 


ACCESS 


Identify direct access space to a CMS 
virtual machine, create extensions and relate 
the disk space to a logical directory. 


CMDCALL 


Converts EXEC 2 extended plist function 
calls to CMS extended plist command calls. 


COMPARE 


Compare records in CMS disk files. 


CONWAIT 


Causes a program to wait until all pending 
terminal I/O is complete. 


COPYFILE 


Copy CMS disk files according to 
specifications. 


CP 


Enter CP commands from the CMS 
environment. 


DEBUG 


Enter DEBUG subcommand environment. 


DEFAULTS 


Set or display default options for the 
command: FILELIST 


DESBUF 


Clears the program stack and the terminal 
input buffers. 


DROPBUF 


Eliminate a program stack buffer. 


ERASE 


Delete CMS disk files. 


ESTATE 


Verify the existence of a CMS disk file. 


ESTATEW 


Verify the existence of a CMS disk file on a 
read/write CMS disk. 



Figure 7-3 (Part 1 of 4). Summary of CMS Commands 
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Command 


Usage 


EXEC 


Execute special procedures made up of 
frequently used sequences of statements. 


EXECIO 


Do I/O operations between a device and 
the program stack. 


EXECOS 


Resets the OS environment under CMS 
without returning to the interactive 
environment. 


EXECUPDT 


Produces an updated executable version of 
a System Product Interpreter source 
program. 


EXPORT 


Make a copy of a CMS file as a Personal 
Computer file. 


FILEDEF 


Define an OS ddname and relate that 
ddname to any device supported by CMS. 


FILELIST 


List information about CMS disk files, with 
the ability to edit and issue commands from 

uiC list. 


FINIS 


Close an open file. 


FORMAT 


Prepare disks in CMS fixed block format. 


GENDIRT 


Fill in auxiliary module directories. 


GENMOD 


Generate executable CMS files (MODULE 
files). 


GLOBAL 


Identify specific CMS libraries to be 
searched for macros, copy files, or missing 
subroutines. 


GLOBALV 


Set, maintain, and retrieve a collection of 
named variables. 



Figure 7-3 (Part 2 of 4). Summary of CMS Commands 
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Command 


Usage 


IDENTIFY 


Display or stack userid, date, time, time 
zone, and day of the week. 


IMMCMD 


Establishes or cancels immediate commands 
from within an EXEC. 


IMPORT 


Make a copy of a Personal Computer file on 
a CMS minidisk. 


INCLUDE 


Bring additional TEXT files into storage 
and establish linkages. 


LISTFILE 


List information about CMS disk files. 


LOAD 


Bring TEXT files into storage for execution. 


LOADMOD 


Bring a single MODULE file into storage. 


MACLIB 


Create or modify CMS macro libraries. 


MAKEBUF 


Create a new program stack buffer. 


MODMAP 


Display the load map of a MODULE file. 


NUCXDROP 


Delete specified nucleus extensions. 


NUCXLOAD 


Load a nucleus extension. 


NUCXMAP 


Identify existing nucleus extensions. 


PRINT 


Spool a specified CMS file to the system 
printer. 


QUERY 


Request information about a CMS virtual 
machine. 


RELEASE 


Make a disk and its directory inaccessible to 
a CMS virtual machine. 


RENAME 


Change the name of a CMS file or files. 



Figure 7-3 (Part 3 of 4). Summary of CMS Commands 
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Command 


Usage 


RESERVE 


Allocates all available blocks of a 512, IK, 
2K, or 4K-byte block formatted minidisk to 
a unique CMS file. 


SENTRIES 


Determine the number of lines currently in 
the program stack. 


SET 


Establish, set, or reset CMS virtual machine 
characteristics. 


SORT 


Arranges a specified file in ascending 
EBCDIC order according to sort fields. 


START 


Begin execution of programs previously 
loaded. 


STATE 


Verify the existence of a CMS disk file. 


STATEW 


Verify the existence of a CMS disk file on a 
read/write CMS disk. 


SYNONYM 


Invoke a table containing synonyms you 
have created for CMS and user- written 
commands. 


TXTLIB 


Generate and modify text libraries. 


TYPE 


Display all or part of a CMS file at the 
terminal. 


UPDATE 


Make changes in a program source file as 
defined by control cards in a control file. 


VMPCSERV 


Start the Host Server program so you can 
link your Host 3270 VM Session with your 
Local 3270 Session. 


XEDIT 


Invoke the VM/PC Editor to create or 
modify a disk file. 



Figure 7-3 (Part 4 of 4). Summary of CMS Commands 
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CMS Commands and Options 

This section contains reference information for the 
CMS commands used by general users. Each command 
description indicates the command format, operands 
and options; it also lists error messages and return 
codes the command issues. Usage notes are provided, 
where applicable. 

The formats of the DEBUG, XEDIT, and EXEC 
commands are also listed; for details on the DEBUG 
subcommands or EXEC control statements, see 
VM/SP CMS Command and Macro Reference. 

For information on the REXX language and the System 
Product Interpreter, see the VM/SP System Product 
Interpreter Reference, and the VM/SP System Product 
Interpreter User's Guide. 

For details on the XEDIT subcommands and macros, 
see VM/SP System Product Editor Command and 
Macro Reference. 

For usage information on XEDIT subcommands and 
macros, see VM/SP System Product Editor User's 
Guide. 

For more detailed usage information on CMS 
commands, see the VM/SP CMS User's Guide. 
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ACCESS 



Use the ACCESS command to identify a disk to CMS, 
establish a filemode letter for the files on the disk, and 
set up a file directory in storage. The specifications you 
make with the ACCESS command determine the 
entries in the user file directory. The format of the 
ACCESS command is: 



ACcess 


fcuu modeT/ext [fn [ft [fmllll [(options. 

\m a * * * 

opt ions : 
ERASE 


■•[>]]] 



Where: 



cuu 

makes available the disk at the specified virtual 
device address. The default value is 101. 

Valid addresses are 001 through FFF. [ 

mode 

assigns a one-character filemode letter to all 
files on the disk being accessed. This field must 
be specified if cuu is specified. The default 
value is A. 

ext 

indicates the mode of the parent disk. Files on 
the disk being accessed (cuu) are logically 
associated with files on the parent disk; the disk 
at cuu is considered a read-only extension. A 
parent disk must be accessed in the search 
before the extension. A blank must not precede 
or follow the slash (/). 

fn [ft [fm]] (j 

defines a subset of the files on the specified 
disk. Only the specified files are included in the 
user file directory and only those files can be 
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read. An asterisk coded in any of these fields 
indicates all filenames, filetypes, or filemode 
numbers (except 0) are to be included. (See 
Usage Notes 3 and 4.) To specify a filemode 
use a letter and a number, for example: Bl. 

Options: 

ERASE 

specifies that you want to erase all of the files 
on the specified disk. This option is only valid 
for read/write disks. 

Usage Notes: 

1. If you have defined disk addresses 100, 101, and 
10E in the VM/PC configuration file, or if they are 
defined before you IPL CMS, these disks are 
accessed as the S-, A-, and Y-disks respectively. 
Following an IPL of CMS, you must issue explicit 
ACCESS commands to access other disks. 
Ordinarily, you have access only to files with a 
filemode number of 2 on the system disk. 

2. Associated with each CMS disk is a file directory, 
which contains an entry for every CMS file on the 
disk. The user file directory created in storage by 
the ACCESS command contains entries for only 
those files that you can reference. 

If you use the CP LINK command to link to a new 
minidisk, issue an ACCESS command each time. 
Do this so that you obtain the appropriate file 
directory. 

3. The filename, filetype, and filemode fields can only 
be specified for disks that are accessed as read-only 
extensions. For example: 

access 195 b/a * assemble 
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gives you read-only access to all the files with a 
filetype of ASSEMBLE on the disk at virtual 
address 195. The command: 

access 100 z/a * * z1 

gives you access to all files on the system disk (100) 
that have a f ilemode number of 1 . 

When you access any disk in read-only status, files 
with a filemode number of are not accessed. 

4. You can also identify a set of files on a disk by 
referring to a filename or filetype prefix. For 
example: 

access 192 c/a abc' c 

accesses only those files in the disk at virtual 
address 192 whose filenames begin with the 
characters ABC. The command line: 

access 192 c/a ' c a' c c2 

gives you access to all files whose filetypes begin 
with an A and that have a filemode number of 2. 

5. You can force a read/ write disk into read-only 
status by accessing it as an extension of another 
disk or of itself; for example: 

access 101 a/a 

forces your A-disk into read-only status. 

6. When a disk is made a read-only extension of 
another disk, commands that typically require or 
allow you to specify a filemode may search 
extensions of the specified disk. The exception to 
this is the LISTFILE command. For a detailed 
description of read-only extensions, see the VM/SP 
CMS User's Guide. 
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If you enter the ERASE option by mistake, you can 
recover from the error as long as you have not yet 
written any new files onto the disk. (That is, you 
have not yet caused CMS to rewrite the file 
directory.) Reissue the ACCESS command without 
the ERASE option. 

If two or more disks have been accessed in CMS, 
and CP DEFINE commands are executed that swap 
virtual addresses, then a subsequent RELEASE 
command may write the file directory on the wrong 
disk; for example: 



233 



This sequence of commands will write the file 
directory from 193 to 198 since the CP definitions 
are unknown to CMS. 

To free an accessed disk, refer to the CMS 
RELEASE Command. 



CMS) 


ACCESS 193 


CMS) 


ACCESS 198 


CP) 
CP) 


DEFINE ': ,c )3 


DEFINE 1S8 


CMS) 


RELEASE C 



Responses: 



DMSACC723I mode (cuu) read/only 

This message is displayed if the disk is accessed 
read-only. 

DMSACC724I cuul REPLACES mode(cuu2) 

Before execution of the command, the disk 
represented by cuu2 was the "mode" disk. The 
disk, cuul, is now assigned that filemode letter. 
This message is followed by message 
DMSACC726I. 

DMSACC725I cuu ALSO = 'mode' DISK 

The disk specified by cuu is the mode disk and 
an ACCESS command was issued to assign it 
another filemode letter. 
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DMSACC726I 'cuu mode' RELEASED 

The disk being accessed at virtual address cuu 
as a read/ write disk is already accessed at a 
different mode. It is released from that mode. 
Or, a disk currently accessed at mode is being 
replaced. 

Other Messages and Return Codes: 

DMSACC003E INVALID OPTION 'option' RC=24 

DMSACC017E INVALID DEVICE ADDRESS 'cuu' RC=2^ 

DMSACC048E INVALID MODE 'mode' RC=2^ 

DMSACC059E 'cuu' ALREADY ACCESSED AS READ/WRITE 'mode' DISK RC=36 

DMSACC060E FILE(S) 'fn [ft [fm]]' NOT FOUND. DISK 'mode(cuu)' WILL 

NOT BE ACCESSED RC=28 
DMSACC070E INVALID PARAMETER 'parameter' RC=2*f 
DMSACC109S VIRTUAL STORAGE CAPACITY EXCEEDED RC=104 
DMSACC112S DISK 'mode(cuu)' has invalid directory format RC=100 
DMSACC113S mode (cuu) NOT ATTACHED RC=100 
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CMDCALL 



Use the CMDCALL command to convert EXEC 2 
extended PLIST function calls to CMS extended or 
standard PLIST command calls. 

The format of the CMDCALL command is: 



CMDCALL 



[cmd [operand! [operand2 ... operandn]]] 



For a complete description of the CMDCALL 
command, refer to the VM/SP CMS Command and 
Macro Reference. 
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COMPARE 



Use the COMPARE command to compare two CMS 
disk files of of fixed- or variable-length format on a 
record-for-record basis and to display dissimilar records 
at the terminal. The format of the COMPARE 
command is: 



COMpare 



fileidl f i 1 e i d2 [(option. 
Option: 



•[>]] 



C0Lfmmm[-] 
Li J_r 



nnn~| 
eel J 



For a complete description of the COMPARE 
command, refer to the VM/SP CMS Command and 
Macro Reference. 
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CONWAIT 



Use the CONWAIT command to cause a program to 
wait until all pending terminal I/O is complete. The 
format of the CONWAIT command is: 



CONWAIT 



Usage Note: The CONWAIT command synchronizes 
input and output to the terminal; it ensures that the 
output console stack is cleared before the program 
continues execution. Also, you can ensure that a read 
or write operation is finished before you modify an I/O 
buffer. 
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COPYFILE 



Use the COPYFILE command to copy and/or modify 
CMS disk files. The manner in which the file identifiers 
are entered determines whether or not one or more 
output files are created. The format of the COPYFILE 
command is: 



COPYfile 



f i leidM [f i leldf 2. . . ] [fileido] [ (opt ions ...[)] ] 

opt ions : 

[Type "I [NEWDatel fNEWFi lei fPRompt 1 
[ NOType] [OLDDateJ [_REP 1 acej |N0PRompt] 

FRom recno Ir OR numrec ||SPecs 

FRLabel xxxxxxxx TOLabel xxxxxxxx NOSPecs I 



[FRom recno | F 

FRLabel xxxxxxxx Jlj 

fbviy irRECfm Jf/1 
LAPpendJ[ )\J)] 

fpAck 1 
[UNPackJ 



[Single] 



Fill c 
Fill hh 
Fill kO 



[LRecl 
EBcdic] 



IfsPecs 1 
>cj| _NQ$PecsJ 

nnnnn] ITRUnc | 
[ NOTRuncj 

TuPcasel [TRAns] 
[LOwcaseJ 



For a complete description of the COPYFILE 
command, refer to the VM/SP CMS Command and 
Macro Reference. 
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CP 



Use the CP command to transmit commands to the 
VM/SP control program environment without leaving 
the CMS environment. The format of the CP 
command is: 



CP 



command 1 i ne 



Where: 

command 1 i ne 

is any CP command valid for your CP command 
privilege class. If this field is omitted, you are 
placed in the CP environment and may enter 
CP commands without preceding each 
command with CP. To return to CMS, issue the 
CP command BEGIN. 

Usage Notes: 

1 . You must use the CP command to invoke a CP 
command: 

. From within a CMS EXEC or an EXEC 2 
EXEC. 

• If the implied CP (IMPCP) function is set to 
OFF for your virtual machine 

2. To enter a CP command from the CMS 
environment without CMS processing the command 
line, use #CP. 

3. When you enter an invalid CP command following 
the CP command, you receive a return code of -1. 
In an EXEC, this return code is +1. 
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Responses: All responses are from the CP command 
that was issued; the CMS ready message follows the 
response. 
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DEBUG 



Use the DEBUG command to enter the debug 
environment from the CMS environment. In the debug 
environment you can use a variety of DEBUG 
subcommands that allow you to test and debug your 
programs. For tutorial information, including examples, 
see the VM/SP CMS User's Guide. The format of the 
DEBUG command is: 



DEBUG 



Usage Notes: 

1 . The debug environment is also entered as a result of 
an external interruption or the result of a 
breakpoint (address stop) encountered during 
program execution. 

2. Once you are in the debug environment, you can 
enter only DEBUG subcommands and CP 
commands via the #CP function. 

3. To return to the CMS environment, enter the 
DEBUG subcommand RETURN. 

Responses: 

DMSDBG728I DEBUG ENTERED 

This message indicates that you are in the debug 
environment. 
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DEFAULTS 



Use the DEFAULTS EXEC procedure to set up default 
options for the FILELIST command. Each time you 
invoke FILELIST, the options specified in the 
DEFAULTS command are in effect. However, the 
options specified with each invocation of FILELIST 
override the ones set up in the DEFAULTS command. 
Thus, you can customize the options by using 
DEFAULTS, yet override them when you desire. 
DEFAULTS can also be used to display the current 
default options for the FILELIST command. 

The format of the DEFAULTS command is: 



DEFAULTS 




" Set FILELIST options. . ." 
List 





Where: 

Set 

specifies that default options are to be set up for 
the FILELIST command. 

List 

specifies that the current default options for the 
FILELIST command are to be displayed. 

opt ions 

is one or more options associated with the 
FILELIST command, as shown below. 

The FILELIST command and the options that can be 
specified as defaults are listed below. Valid 
abbreviations for both the command name and the 
keyword options are indicated by uppercase letters. 
Mutually exclusive options are listed one under the 
other. 
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Command Name Options 

Filelist Profile fn Filelist 

Profile PROFFLST NOFilelist 

Usage Notes: The DEFAULTS command uses the 
GLOBALV command, which maintains a LASTING 
GLOBALV file on your A-disk. This file contains the 
options specified in a DEFAULTS command. 
However, do not edit the LASTING GLOBALV file to 
change the options. Use the DEFAULTS command, 
instead. For more information on GLOBALV files, see 
the description of the GLOBALV command. 

Responses: The following is a list of your default 
options for the FILELIST command: 

opt ion . . . 

To change these default options enter: 

'DEFAULTS Set FILELIST opt I [opt2..]'. 
The following default options have been set: 
FILELIST option... 

To change any default options enter: 

DEFAULTS Set FILELIST opt] [opt2..] 

Error Messages and Return Codes: 

DMSWDF014E INVALID KEYWORD 'function 1 . RC=24 

DMSWDF029E INVALID PARAMETER 'parm' IN THE OPTION 'option' FIELD. 

RC=2^ 
DMSWDF637E MISSING VALUE FOR THE PROFILE OPTION. RC=24. 
DMSWDF641E NO {opt ions I command] SPECIFIED. RC=24 
DMSWDF6^2E DEFAULTS DOES NOT ACCEPT {'COMMAND' command I ' OPT I ON ' 

OPTION FOR 'COMMAND'}. RC=24 
DMSWDF653E ERROR EXECUTING 'GLOBALV 1 , RC = nn. RC=40 
DMSSTT062E INVALID CHARACTER 'character' IN FILE ID 'fn ft fm'. RC=20 
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DESBUF 



Use the DESBUF command to clear the console and 
program stack input and output buffers. The format of 
the DESBUF command is: 



DESBUF 



Usage Notes: Note that DESBUF clears the output 
buffers as well as the input buffers. Use the 
CONWAIT command before DESBUF to halt program 
execution until all output lines are displayed at the 
terminal. 

Warning: Be careful when using the DESBUF 
command because the input and output console and 
program stack buffers are used to communicate 
information between programs. 
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DROPBUF 



Use the DROPBUF command to eliminate the most 
recently created program stack buffer. The format of 
the DROPBUF command is: 



DROPBUF 



Where: 

n 

indicates the number of the first program stack 
buffer you want to drop. CMS drops the 
indicated buffer and all buffers created after it. 
If n is not specified, only the most recently 
created buffer is dropped. 

Usage Note: Note that you can specify a number with 
DROPBUF. For example, if you issue: 

DROPBUF h 

CMS eliminates program stack buffer 4 and all program 
stack buffers created after it. Thus, if there were 
presently six program stack buffers, CMS would 
eliminate program stack buffers 6, 5, and 4. If you 
issued DROPBUF without specifying n, only program 
stack buffer 6 would be eliminated. 
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ERASE 



Use the ERASE command to delete one or more CMS 
files from a read/ write disk. The format of the ERASE 
command is: 



ERASE 



S fnM ft { [fm] [(options. 

opt ions: 

[Type 1 
I Notype I 



• [)]] 



For a complete description of the ERASE command, 
refer to the VM/SP CMS Command and Macro 
Reference. 
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ESTATE/ESTATEW 



Use the ESTATE command to verify the existence of a 
CMS file on any accessed disk; use the EST ATE W 
command to verify the existence of a CMS file on any 
accessed read/write disk. In most instances, the 
commands ESTATE and ESTATEW are equivalent to 
STATE and STATEW. However, if the file being 
verified has more than 65535 items or more than 65535 
data blocks, then the ESTATE/ESTATEW commands 
should be used. Use of the STATE/STATEW 
commands will result in error message DMSSTT253E 
FILE 'fn ft fm' CAN NOT BE HANDLED WITH 
SUPPLIED PLIST. The use of ESTATE/ESTATEW 
will not produce this message, and is therefore 
preferred if the existence of such a file may be verified. 
The formats of the ESTATE and ESTATEW 
commands are: 



(ESTATE [ jfn/ jft/ \[fn\] 

IestatewI ] *M *U * 



Where: 

fn 



is the filename of the file whose existence is to 
be verified. If fn is specified as *, the first file 
found satisfying the rest of the fileid is used. 



ft 



is the filetype of the file whose existence is to 
be verified. If ft is specified as *, the first file 
found satisfying the rest of the fileid is used. 

fm 

is the filemode of the file whose existence is to 
be verified. If fm is omitted, or specified as *, 
all your disks are searched. 
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Usage Notes: 

1 . If you issue the ESTATEW command specifying a 
file that exists on a read-only disk, you receive error 
message DMSSTT002E. 

2. When you code an asterisk in the fn or ft fields, the 
search for the file is ended as soon as any file 
satisfies any of the other conditions. For example, 
the command: 

estate * file 

executes successfully if any file on any accessed 
disk (including the system disk) has a filetype of 
FILE. 

3. You can invoke the EST ATE/ESTATE W 
command from the terminal, from an EXEC file, or 
as a function from a program. If 
ESTATE/ESTATEW is invoked as a function or 
from an EXEC file that has the message output 
suppressed, the message DMSSTT002E FILE 'fn ft 
fm ? NOT FOUND is not issued. 

Response: The CMS ready message indicates that the 
specified file exists. 

Error Messages and Return Codes: 

DMSSTT002E FILE 'fn ft fm' NOT FOUND RC=28 

DMSSTT048E INVALID MODE 'mode' RC=24 

DMSSTT05^E INCOMPLETE FILE ID SPECIFIED RC=24 

DMSSTT062E INVALID CHARACTER 'char' IN FILE ID 'fn ft 1 RC=20 

DMSSTT069E DISK 'mode' NOT ACCESSED RC=36 

DMSSTT070E INVALID PARAMETER 'parameter' RC=24 
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EXEC 



Use the EXEC command to execute one or more CMS 
commands or EXEC control statements contained in a 
specified System Product Interpreter, CMS EXEC or 
EXEC 2 file. The format of the EXEC command is: 



[EXec] 



fn [args...] 



For a complete description of the EXEC command, 
refer to the VM/SP CMS Command and Macro 
Reference. 
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EXECIO 

Use the EXECIO command to: 

• Write lines from the program stack to a CMS disk 
file or to a virtual printer. 

• Cause execution of CP commands and recover 
resulting output. 

In some cases output data to be written may be 
supplied directly on the EXECIO command line. 

The format of the EXECIO command is: 



EXECIO 



OPTIONS-SEE BELOW 
{lines} {DISKR fn ft [fm[ 1 inenum] ] [([FINIs] [a][b]] } 



} ( 

(CP [( 

{DISKW fn ft fm [1 inenum 

{ [recfm [lrecl]]] [([FINIs] 

{PRINT [([CC {code}] 

{ [ {DATA} ] 

{EMSG [( 



Option formats: 

(a) 

Find /chars/ 
LOcate /chars/ 
Avoid /chars/ 
Zone {n1 n2} 

U *} 

LIFO 
FIFO 
SKip 



(b) 

Margins {nl n2} 

U :> 

STRIP 
NOTYPE 



} 
[a][b][d]] [)]} 

[b][c][d] } 
[b][c][d]] [)]} 

[b][c][d]] [)]} 



(c) 

CAse {U} 
{M} 



(d) 

STring xxx. 



Note: Parsing of the EXECIO command differs from 
that of other CMS commands in that it involves 
handling of strings that may contain embedded blanks, 
parenthesis, other special characters, and words of 
more than eight characters. Therefore, if a right 
parenthesis is used to mark the end of an EXECIO 
option, it must be preceded by at least one blank 
character. A right parenthesis cannot be used to mark 
the end of the STRING option. 

Since VM/PC does not support virtual readers or 
punches, these devices are not valid in the EXECIO 
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command. Except for that, the VM/PC EXECIO 
command is functionally equivalent to the VM/SP 
command. 

When EXECIO is first called, it is loaded into CMS 
free storage and installed as a nucleus extension. 
Further calls to EXECIO normally use this copy of 
EXECIO, thus eliminating the need to reload the 
EXECIO module. 

For a complete description of the EXECIO command, 
refer to the VM/SP CMS Command and Macro 
Reference. 
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EXECOS 



Use the EXECOS command to reset the OS 
environment under CMS without returning to the 
interactive environment. You can issue the EXECOS 
command with no operands or preceding a CMS 
command. If EXECOS precedes a CMS command, the 
CMS command is processed then the EXECOS 
command performs the OS reset. If you issue 
EXECOS with no operands, the OS environment is 
reset. 

The VM/PC CMS EXECOS command differs from 
the VM/SP EXECOS command in that it does not do a 
VSAM reset. 

The format of the EXECOS command is: 



EXECOS 



[cmd [operand! [operand2 



operandn] ] ] 



For a complete description of the EXECOS command, 
refer to the VM/SP CMS Command and Macro 
Reference. 
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EXECUPDT 



Use the EXECUPDT command to apply updates to a 
System Product Interpreter source program and create 
an executable version of the program. This command 
can only be used with System Product Interpreter 
program. See the VM/SP System Product Interpreter 
Reference for information on how to set up a program 
for updating. See the VM/SP System Product Editor 
Command and Macro Reference for information about 
editing files in update mode with the System Product 
Editor. 

EXECUPDT creates an executable program from a 
fixed-format 80-column sequenced source file. The 
filetype of the source file must begin with a dollar sign 
($), for example $EXEC or $XEDIT. You do not 
enter this dollar sign when you enter the filetype on the 
EXECUPDT command. EXECUPDT updates files in 
the same manner as the UPDATE command and 
accepts all UPDATE command options. In addition to 
the UPDATE command options, EXECUPDT has 
options that allow you to request removal of Support 
Identification (SID) codes from the file, include a log of 
applied updates with the file, or remove comments from 
the file to improve performance. 

The format of the EXECUPDT command is: 
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EXECUPDT 



fn [ft [fm]]; 
[EXEC [" ]] 

options : 



[(opt 



ions. 



[)]] 



[CTL fn1 

: HISTorylNOHISTory] 
: C0MPRESS|N0C0MPress] 
S I D I NOS I D] 
: N0UPdate] 



For a complete description of the EXECUPDT 
command, refer to the VM/SP CMS Command and 
Macro Reference. 
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EXPORT 



Use the EXPORT command to make a copy of a CMS 
file as a Personal Computer file. The format of the 
EXPORT command is: 



EXPort 


fn ft fm d:f i lename.ext [(opt 


ions. 


••[)]] 




where options may be: 
[ REP or REPLACE 


] 






[ASCI 1 or NOASCI 1 


] 






[EOL or NOEOL 


] 





Where: 

fn 
ft 



fm 



is the filename of the CMS file to export, 
is the filetype of the CMS file to export. 

is the filemode of the CMS file to export. 

Note: You must specify a fn, ft, and fm when 
using the EXPORT command. 



d : f i lename.ext 

is the filespec of the Personal Computer file to 
be created. The drive and filename must be 
specified. The filename extension is optional. 
No special characters (?,*) are allowed in the 
filespec. 

REP or REPLACE 

Specifies that an existing Personal Computer 
file with the fileid specified will be replaced with 
the specified CMS file. 
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ASCI I or NOASCI I 

ASCII specifies that the file is to be translated 
from EBCDIC to ASCII during the EXPORT. 
NO ASCII specifies that the file is not to be 
translated from EBCDIC to ASCII during the 
EXPORT. ASCII is the default. 

EOL or NOEOL 

EOL specifies that end-of-line characters 
(carriage return/line feed) are to be inserted 
into the target file to delimit the lines of the file. 
NOEOL specifies that the target file is to be 
created without inserting end-of-line characters 
to delimit lines of the file. EOL is the default. 

Notes: 

1 . The EXPORT command may create a temporary 
file called "EXPORT.CMS" during the export of 
the CMS file. Any file which you have on the target 
disk called "EXPORT.CMS" will be erased if the 
EXPORT command is used. 

2. The CMS file to be exported must have a logical 
record length of 65535 or less if the EOL option is 
to be used. If the LRECL of the file exceeds this, it 
cannot be exported with the EOL option. 

3. A file which has been exported, translated to 
ASCII, and subsequently imported may differ from 
the original file, due to the translate tables used in 
the file transformations. The NO ASCII options 
should be used to avoid problems caused by this 
transformation. Appendix D, "ASCII to EBCDIC 
Conversion" on page D-l lists the EBCDIC- ASCII 
conversion tables which are used in this translation. 
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Messages and Return Codes: 



DMSEXP002E File 'fn ft fm not found RC=28 

DMSEXP003E I nval id opt ion 'option' RC=2*f 

DMSEXP02^E File 'd: f i lename.ext ' already exists — 

specify 'replace' RC=28 

DMSEXP042E No fileid(s) specified RC=24 

DMSEXP048E Invalid mode 'mode' RC=2*f 

DMSEXP05^E Incomplete fileid specified RC=24 

DMSEXP062E Invalid * in fileid RC=20 

DMSEXP070E Invalid parameter 'parameter' RC=24 

DMSEXPIO^E Error 'nn' reading file 'fn ft fm' from disk RC=100 

DMSEXP622E Insufficient storage available RC=4 1 

DMSEXP800E Invalid export of a CMS file to a system file RC=100 

DMSEXP804E Invalid PC fileid ' d: fi lename.ext ' specified RC=20 

DMSEXP806E Export terminated, insufficient disk 

space available RC=32 

DMSEXP807S Drive d not ready. Make drive ready and press enter 

DMSEXP808S File cannot be exported with the ' EOL ' option RC=20 

DMSEXP907E I/O error on file 'd:fi lename.ext ' RC=256 

DMSSTT048E Invalid mode 'mode' RC=24 

DMSSTT062E Invalid character 'char' in fileid 'fn ft fm' RC=20 

DMSSTT069E Disk 'mode' not accessed RC=36 
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FILEDEF 



Use the FILEDEF command to establish data 
definitions for OS ddnames, or to override default file 
definitions made by the assembler and the OS language 
processors. The format of the FILEDEF command is: 



Fl ledef 



Sddname) 
2 n \ 



Termi na 1 

PRinter 

DIS 



[(optionA optionC[)j] 

[(optionA OPTCD j[)]] 

K [~fn ft rfm"]"| [ (opt ionA opt ionB[ 
[ _F I LE ddname [_AlJJ 

QDISK fn ft ir fm "ll ( DSN ? 
FILE ddname A1 <DSN quail qu 
-"- (DSN quail. qu 

[ (optionA optionB[ )] ] 



al2 
a!2 



DISK vaddr 

DUMMY 

GRAF cuu 
CLEAR 



[(optionA[)]] 
[(optionA[)]] 



optionA : 
[PERM] 



OPTIONS 

opt ionB : 
[KEYLEN nnn] 



[ CHANGE I fxTENT nnnnnl 

InochangeJ I 50 

RECFM a] 
'LRECL nnnnn] 

BLOCK nnnnn | 
BLKSIZE nnnnnl 



opt ionC : 
1 1 1 d r a c r I 

IlowcaseJ 



LIMCT nnn] 

OPTCD a] 

DISP MOD] 

MEMBER membername] 

CONCAT] 



DSORG 



PS ) 
P0 > 
DA j 



Because VM/PC does not support virtual readers, 
punches, or tapes, these devices are not valid in the 
FILEDEF command. Except for this, the VM/PC 
FILEDEF command is functionally equivalent to the 
VM/SP command. 
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For a complete description of the FILEDEF command, 
refer to the VM/SP CMS Command and Macro 
Reference. 
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FILELIST 



Use the FILELIST EXEC procedure to display a list of 
information about CMS files residing on accessed disks. 
In the FILELIST environment, information that is 
normally provided by the LISTFILE command (with 
the DATE option) is displayed under the control of the 
System Product editor. You can use XEDIT 
subcommands to manipulate the list itself. You can 
also issue CMS commands against the files directly 
from the displayed list. 

The format of the FILELIST command is: 



FILEList 



[fn [ft [fm]]] [(options. ..[)]] 

opt ions : 
Append] 

Tilelistl Nof ilelisf 
PROFile fn] 



The VM/PC command FILELIST is functionally 
equivalent to the VM/SP command FILELIST, except 
that PF 1 will perform a sort of the list of files based on 
the filenames in the list. 

For a complete description of the FILELIST command, 
refer to the VM/SP CMS Command and Macro 
Reference. 
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FINIS 



Use the FINIS command to close one or more files. 
The format of the FINIS command is: 



FINIS 



fn ft fm 



Where: 



fn 



ft 



is the filename of the file to be closed. If you 
code an asterisk (*) in this field, all filenames 
are closed. 



is the filetype of the file to be closed. If you 
code an asterisk (*) in this field, all file types are 
closed. 



fm 



is the filemode of the file to be closed. If you 
code an asterisk (*) in this field, all disks are 
searched for the specified file. If this field is 
omitted, Al is assumed. 

Usage Note: Use FINIS when your program does not 
close a file during its execution. CMS commands close 
files automatically at the end of their execution. (An 
'EXEC file is considered to be a single CMS 
command, independent of its content.) 
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FORMAT 

Use the FORMAT command to: 

• Initialize a virtual disk (minidisk) for use with CMS 
files 

• Count or reset the number of blocks on a minidisk 

• Write a label on a minidisk 

The format of the FORMAT command is: 



FORMAT 


c 




uu mode [nob 
pt ions: 
Biksize 

Noerase 
Label 
_Recomp 


Ik] [(op 

512" 
1024 
2048 
4096 

IK 

2K 

4K 


tions. ..[)]] 



Where: 



cuu 



is the virtual device address of the minidisk to 
be formatted. 



Valid addresses are 001 through FFF. 



mode 



is the filemode letter to be assigned to the 
specified device address. Valid filemode letters 
are A through Z. This field must be specified. 
If any other disk is accessed as mode, it is 
released. 



/-no v ivi/ r ^ u ser s ijuiue 



nob Ik 

is the number of FB-512 blocks to be made 
available for use. If the number specified 
exceeds the actual number of blocks on the 
disk, then all the blocks on the disk are made 
available for use. 



Options: 



BLKSIZE 

specifies the physical DASD block size of the 
CMS minidisk. The block sizes 1024, 2048, 
and 4096 may alternately be specified as IK, 
2K, and 4K, respectively. For FB-512 devices, 
only block sizes 512, 1024, 2048, and 4096 are 
supported. 

N0ERASE 

specifies that the permanently formatted 
FB-512 blocks are not to be cleared to zeros. If 
not specified, the FB-512 blocks will be cleared. 

LABEL 

writes a label on the disk without formatting the 
disk. The CMS disk label is written on block 1 
of an FB-512 device. A prompting message 
requests a six-character disk label (fewer than 
six characters are left- justified and blanks 
padded). 

REC0MP 

changes the number of FB-512 blocks on the 
disk that are available to the user. This number 
becomes the actual number of minidisk FB-512 
blocks, or the number specified by noblk, 
whichever is less. If noblk is not specified, the 
maximum number of blocks initially formatted 
on the disk is made available to the user. 
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Usage Notes: 

1. When you do not specify either the RECOMP or 
LABEL option, the disk area is initialized by 
writing records containing binary zeros on each 
block. Any previous data on the disk is erased. For 
example: 

format 101 a 1000 

initializes 1000 blocks of the disk located at virtual 
address 101 in CMS format. The command: 

format 102 b 800 (recomp) 

changes the number of blocks available at virtual 
address 102 to 800, but does not erase any existing 
CMS files. To change only the label on a disk, you 
can enter: 

format 103 c ( label ) 

Respond to the prompting message with a 
six-character label. 

2. When formatting FB-512 devices, enough blocks of 
the minidisk area must be formatted to support the 
CMS disk structure, or message DMS216E will be 
displayed, and the FORMAT request will be 
terminated. The number of FB-512 blocks which 
must be formatted for minidisks of 5 12-, 1K-, 2K-, 
and 4K-byte CMS blocksize is 6, 12, 24, and 48, 
respectively. 

3. If the FORMAT command with the RECOMP 
option fails and CMS issues message 
DMSFOR214W, "CANNOT RECOMPUTE 
WITHOUT LOSS OF DATA. NO CHANGE.," 

query your A-disk to determine the number of 
unallocated blocks. If the number of blocks seems 
adequate, it is possible that some of the allocated 
space is at the end of the disk, and is thus not 
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available to the FORMAT command. Issue the 
command: 

COPY * * A = = = (REP 

followed by the FORMAT command with the 
RECOMP option. 

4. Choosing an appropriate BLKSIZE to format a disk 
depends upon its intended use. A 4K BLKSIZE 
will optimize the I/O if the disk is to contain large 
files with no missing records (dense). A BLKSIZE 
of IK is more appropriate when creating many 
small files or sparse files. For example, PL/I 
regional files are sparse and they may allocate more 
space on a 4K disk than on a IK disk, therefore, the 
smaller BLKSIZE is preferable. 

The larger the blocksize of the disk, the greater the 
amount of storage required for input/output 
buffers. Each buffer that the system needs must be 
a contiguous block of system storage. The size of 
this area of storage being the blocksize of the disk. 
Programs that dynamically allocate storage based 
upon machine size may use up all of the available 
storage. This may not allow the system enough 
storage to allocate buffers for its use. 
Consequently, a program needing a 4K disk that 
uses all of the available storage may be unable to 
get I/O buffers if they are not already allocated. 
For more information on CMS storage 
management, refer to the VM/SP System Logic and 
Problem Determination Guide Vol. 2 - CMS. 

Responses: 

DMSFOR603RFORMAT WILL ERASE ALL FILES ON DISK 
'mode(cuu) ' . 
DO YOU WISH TO CONTINUE? (YES I NO) : 

Reply yes or no. If you respond 'YES', you 
must only enter the character string 'YES'. You 
have indicated that a disk area is to be 
initialized; all existing files are erased. If the 
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character string contains leading or trailing 
blanks, such as ' YES' or 'YES ', the response is 
processed as a 'NO' response. Responding 
'NO', pressing the ENTER key, or entering a 
character string other than 'YES' cancels 
execution of the FORMAT command. 

DMSFOR605R ENTER DISK LABEL: 

You have requested that a label be written on 
the disk. Enter a one- to six-character label. 

DMSFOR705I DISK REMAINS UNCHANGED. 

The response to message DMSFOR603R was 
NO or a null line was entered. 

DMSF0R732I ' nnnnnnnnnn ' FB-512 BLOCKS FORMATTED 
ON DISK 'modetcuu)' 

The format operation is complete. 
DMSFOR733I FORMATTING DISK 'mode' 

The disk represented by mode letter 'mode' is being 
formatted. 

LABEL CUU M STAT CYL TYPE BLKSIZE FILES BLKS USED-(%) BLKS LEFT BLK TOTAL 
label cuu m R/W nnn type blksize nnnnn nnnn- % nnn nnnnnn 

This message provides the status of a disk when 
you use the RECOMP option. The response is 
the same as when you issue the QUERY 
command with the DISK operand. 
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Other Messages and Return Codes: 

DMSF0R003E INVALID OPTION 'option' RC=24 
DMSF0R005E NO 'option' SPECIFIED RC=24 
DMSF0R017E INVALID DEVICE ADDRESS 'cuu' KZ=lk 
DMSF0R028E NO DEVICE SPECIFIED RC=24 
DMSFOR037E DISK 'mode[ (cuu) ] ' IS READ/ONLY RC=36 
DMSF0R048E INVALID MODE 'mode' RC=24 
DMSF0R069E DISK 'mode' NOT ACCESSED RC=36 
DMSF0R070E INVALID PARAMETER 'parameter' RC=24 
DMSF0R113S DEVICE 'cuu' NOT ATTACHED RC=100 
DMSFORII^S 'cuu' IS AN UNSUPPORTED DEVICE TYPE 

OR REQUESTED BLKSIZE IS NOT SUPPORTED 

FOR THE DEVICE RC=88 
DMSFOR125S PERMANENT UNIT CHECK ON DISK 'mode(cuu)' RC=100 
DMSF0R126S ERROR {READ I WRIT} I NG LABEL ON DISK 'mode(cuu)' RC=100 
DMSF0R21W CANNOT RECOMPUTE WITHOUT LOSS OF DATA. NO CHANGE RC=8 
DMSF0R216E INSUFFICIENT BLOCKS ON DISK TO SUPPORT 

CMS DISK STRUCTURE RC=100 
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GENDIRT 



Use the GENDIRT command to fill in a CMS auxiliary 
directory. The auxiliary directory contains the name 
and location of modules that would otherwise 
significantly increase the size of the resident directory, 
thus increasing search time and storage requirements. 
By using GENDIRT to fill in an auxiliary directory, the 
file entries for the given command are loaded only 
when the command is invoked. The format of the 
GENDIRT command is: 



GENDIRT 



d i rectoryname [ targetmode] 



For a complete description of the GENDIRT 
command, refer to the VM/SP CMS Command and 
Macro Reference and VM/SP System Programmer's 
Guide. 
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GENMOD 



Use the GENMOD command to generate a module file 
on a CMS disk. The format of the GENMOD 
command is: 



Genmod 



[fn [ MODULE pm! ]] [ (opt ions ...[)] ] 

N 

options: [ FROM entry! ] [ TO entry2 ] 



[map ~| [str 1 [os "i 
[nomapJ [nostrJ [all] 



([SYstem] [SErvice] 
[ENdcmd] [IMmcmd] [Push] [)] 



Where: 



fn 



is the filename of the MODULE file being 
created. If fn is not specified, the file created 
has a filename equal to that of the first entry 
point in the LOAD MAP. 



fm 



is the filemode of the MODULE file being 
created. If fm is not specified, Al is assumed. 

Options: If conflicting options are specified, the last 
one entered is used. 

FROM entryl 

specifies an entry point or a control section 
name that represents the starting virtual storage 
location from which the copy is generated. 

TO entry2 

specifies an entry point or a control section 
name that represents the ending virtual storage 
location from which the copy is generated. 
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MAP 

copies system loader table entries for the 
generated module into a load map record which 
is included at the end of the MODULE file. 
The record can contain as many as 3276 load 
map entries. The MODMAP command can be 
issued to display the load map. 

NOMAP 

specifies that a load map is not to be contained 
in the MODULE file. 

Note: If a module is generated with the 
NOMAP option, that module cannot later be 
loaded and started with the CMS LOADMOD 
and START commands. When NOMAP is 
specified, the information produced is not 
sufficient for the START command to execute 
properly. However, a module generated with 
the NOMAP option can later be invoked as a 
command; that is, it can be invoked if its 
filename is entered. 

STR 

invokes the CMS storage initialization routine 
when the MODULE file is subsequently loaded 
(see the LOADMOD command description). 
This routine frees any storage remaining from a 
previous program. STR is the default setting if 
the MODULE is to be loaded at the beginning 
of available user storage. 

If you have issued CMS SET RELPAGE ON, 
STR causes CMS storage initialization to 
release the remaining pages of storage. 

Note: If a program running in the user area 
calls a transient routine that was generated with 
the STR option, the user area storage pointers 
will be reset. This reset condition could cause 
errors upon return to the original program (for 
example, when OS GETMAIN/FREEMAIN 
macros are issued in the user program). 
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NOSTR 

indicates that, when the MODULE is loaded, 
free storage pointers are not reset for any 
storage currently in use. NOSTR is the default 
setting if the MODULE file is to be loaded at a 
location other than the default load address. 

OS 

indicates that the program may contain OS 
macros and, therefore, should be executed only 
when OS Simulation is available. 

ALL 

indicates that the program: 

• Contains CMS macros and must be capable 
of running regardless of whether OS 
Simulation is available or not 

• Contains no OS macros 



SYSTEM 

indicates that when the MODULE file is 
subsequently loaded, it is to have a storage 
protect key of zero. 

SErvice 

indicates that service calls are accepted (for 
instance a PURGE from an abend). 

ENdcmd. 

indicates that the nucleus extension receives 
control at normal end-of-command processing. 

I Mmcmd 

indicates that this nucleus extension can be 
invoked as an Immediate command. 

Push 

causes no check to be made to see if there is 
already a nucleus extension of the same name. 
Otherwise, an existing nucleus extension is not 
overridden. 
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Note: You can specify the SYSTEM, SERVICE, 
ENDCMD, IMMCMD, or PUSH options here on 
the GENMOD command and they will have the 
same effect as though they were specified on the 
NUCXLOAD command. 

Usage Notes: 

1 . The GENMOD command is usually invoked 
following the LOAD command, and possibly the 
INCLUDE command. For example, the sequence: 

load myprog 
genmod testprog 

loads the file MYPROG TEXT into virtual storage 
and creates a nonrelocatable load module named 
TESTPROG MODULE. TESTPROG may now be 
invoked as a user- written command from the CMS 
environment. 

2. Before the file is written, undefined symbols are set 
to location zero and the common reference control 
section is initialized. The undefined symbols are 
not retained as unresolved symbols in the 
MODULE file. Therefore, once the MODULE file 
is generated, those references cannot be resolved 
and may cause unpredictable results during 
execution. 

3. If you load a program into the transient area you 
should issue the GENMOD command with the STR 
option. Be careful if the program uses OS 
GETMAIN or FREEMAIN macros because your 
program, plus the amount of storage obtained via 
GETMAIN, cannot exceed two pages (8192 bytes). 
It is recommended that you do not use GETMAIN 
macros in programs that execute in the transient 
area. 

4. A transient module (loaded with the ORIGIN 
TRANS option) that was generated with the 
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SYSTEM option is written on disk as a fixed-length 
record with a maximum length of 8192 bytes. 

5. If you are using FORTRAN under CMS, use 
FROM MAIN as an option to avoid unpredictable 
results. 

6. If FROM is not specified on the GENMOD 
command, the starting virtual storage location 
(entry point) of the module is either the address of 
fn (if it is an external name) or the entry point 
determined according to the hierarchy discussed in 
Usage Note 4 of the LOAD command description 
in VM/SP Command and Macro Reference. This is 
not necessarily the lowest address loaded. If you 
have any external references before your START or 
CSECT instructions, you must specify the 'FROM 
entry V operand on the GENMOD command to 
load your program properly. 

7. If you are using PL/I under CMS, use FROM 
PLISTART as an option to avoid unpredictable 
results. 

8. In order to generate a CMS module which can be 
loaded and executed as a relocatable nucleus 
extension, the RLDSAVE option should be used on 
the LOAD command. GENMOD will then append 
the relocation data to the module file for use during 
the loading of the module as a nucleus extension. 
For example, the sequence 

load myprog (rldsave gen testprog 

will load the file MYPROG TEXT into virtual 
storage and create a load module named 
TESTPROG MODULE which will have its 
relocation data saved as a record in the MODULE 
file. 

Responses: None. 
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Messages and Return Codes: 



DMSM0D003E INVALID OPTION 'option' RC=2^ 

DMSM0D005E NO {FROM I TO} ENTRY SPECIFIED RC=24 

DMSM0D021E ENTRY POINT 'name' NOT FOUND RC=40 

DMSMOD032E INVALID FILETYPE 'ft' RC=2^ 

DMSMOD037E DISK 'mode' IS READ/ONLY RC=36 

DMSM0D040E NO FILES LOADED RC=^0 

DMSM0D070E INVALID PARAMETER 'parameter' RC=2*f 

DMSMODO^E INVALID USE OF 'FROM' AND 'TO' OPTIONS RC=24 

DMSMOD105S ERROR 'nn' WRITING FILE ' f n ft fm' ON DISK RC=100 

DMSSTT048E INVALID MODE 'mode' RC=2^ 

DMSSTT069E DISK 'mode' NOT ACCESSED RC=36 
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GLOBAL 



Use the GLOBAL command to identify which CMS, 
or OS libraries are to be searched for macros, copy 
files, or subroutines when processing subsequent CMS 
commands. The format of the GLOBAL command is: 



GLobal 



MACLIB [libnamel ... Iibname8] 
TXTLIB 



Where: 



MACLIB 

precedes the specification of macro libraries 
that are to be searched for macros and copy 
files during the execution of language processor 
commands. 

TXTLIB 

precedes the specification of text libraries to be 
searched for missing subroutines when the 
LOAD or INCLUDE command is issued, or 
when a dynamic load occurs (that is, when an 
OS SVC 8 is issued). 

Note: Subroutines that are called by dynamic 
load should (1) contain only VCONs that are 
resolved within the same text library member or 
(2) be resident in storage throughout the 
processing of the original CMS LOAD or 
INCLUDE command. Otherwise, the entry 
point is unpredictable. 

1 ibnamel . . . 

are the filenames of up to eight libraries. 
Filetypes must be MACLIB or TXTLIB, 
accordingly. The libraries are searched in the 
order in which they are named. If no library 
names are specified, the command cancels the 
effect of any previous GLOBAL command. 



Chapter 7. VM/PC Commands 7- 1 29 



Usage Notes: 

1 . A GLOBAL command remains in effect for an 
entire CMS session unless it is explicitly canceled or 
reissued. If a program failure forces you to IPL 
CMS again, you must reissue the GLOBAL 
command. 

2. There are no default libraries; if you wish to use the 
same libraries during every terminal session, place 
the GLOBAL command(s) in your PROFILE 
EXEC. 

3. To find out what libraries have been specified, issue 
the QUERY command with the MACLIB, 
TXTLIB, or LIBRARY operands. (The LIBRARY 
operand requests a display of all libraries.) 

4. For information on creating and/or manipulating 
CMS libraries, see the discussion of the MACLIB 
and TXTLIB commands. 

Responses: None . 

Messages and Return Codes: 

DMSGLB002W FILE 'fn ft' NOT FOUND RC=28 
DMSGLB014E INVALID FUNCTION 'function' RC=24 
DMSGLB0^7E NO FUNCTION SPECIFIED RC=2^4 
DMSGLB108S MORE THAN 8 LIBRARIES SPECIFIED RC=88 
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GLOBALV 



The GLOBALV (GLOBAL Variables) command 
addresses two primary needs: 1) the need for several 
EXECs to share a common set of values; 2) the need to 
retain those values, either temporarily or permanently, 
for subsequent use. 

Sharing 

Values are often given names, describing what they 
represent, for easy reference. Although the values 
often vary, their names usually do not. The 
GLOBALV command processor builds and maintains 
group(s) of named, variable values in free storage for 
shared use by EXECs. EXECs "share" a value by 
referring to it by a common name. When requested, 
GLOBALV retrieves a variable(s) from the group(s) 
and places it in the program stack for subsequent use by 
the requesting EXEC. 

GLOBALV supports use of more than one group. This 
allows for grouping distinct variables that are either 
related or often used together, which facilitates both 
more efficient retrieval and more selective use. The 
"global variable group(s)," built by GLOBALV from a 
set of CMS GLOBALV type files on the user's A-disk 
and extensions, exist throughout an IPL, unless 
explicitly purged or re-initialized. 

Retaining 

When variables are defined or changed, the user decides 
whether the variables or changes are to last: 

1 . For the current IPL only 

2. Throughout an entire session (normally, from 
LOGON to LOGOFF) 

3. Permanently, that is, across sessions 
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Variables defined for the current IPL only are retained 
in storage. Those required longer than a single IPL are 
retained in CMS files on the user's A-disk from where 
they are put in storage. The CMS filenames are 
SESSION GLOBALV (for values required throughout 
the session), and LASTING GLOBALV (for values 
that are to last permanently). These two files and a 
third A-disk file (INITIAL GLOBALV) are the source 
from which the GLOBALV command processor creates 
and initializes the variable(s) in storage. The INITIAL 
file is normally created by the user as an alternative 
way of defining a large number of variables for an IPL. 

The CMS GLOBALV disk files may be of fixed or 
variable format. Fixed format facilitates creation of 
files by users (via editing). It accommodates variables 
whose names and values do not exceed eight bytes 
each. The GLOBALV command processor uses 
variable format which allows for varying length variable 
names and values. In addition, variable format includes 
a special field which, when used, identifies the group 
name into which the variable will be grouped. 

The GLOBALV command processor manages requests 
to define or set (SET...) variables both in storage and in 
the LASTING and SESSION GLOBALV files on the 
user's A-disk. 

The format of the GLOBALV command is: 
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GLOBALV 


1 N IT 

SELECT Tgroup ~| 
1 UNNAMED | 












SET 

SETS namel [valuel] [name2 value2]... 

SETP 






SELECT fgroup "1 

[unnamedJ 


SETL 

SETLS 

SETSL name [value] 

SETLP 

SETPL 

PUT 

PUTS (namel (name2) ... ) 

PUTP 

GET (namel (name2). . . ) 

LIST [namel [name2]...] 






< 


>ELECT /group \ 

V unnamed/ 


STACK namel [name2]... 
STACKR 

PURGE 






GRPLIST 

GRPSTACK 

PURGE 







Note: Although this command (except for the GET 
and PUT options) may be used in CMS EXECS, it is 
designed for use with System Product Interpreter or 
EXEC 2 EXECs. Restrictions and precautions are 
listed in the CMS Command and Macro Reference. 

For a description of the GLOBALV command, refer to 
VM/SP CMS Command and Macro Reference. 
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IDENTIFY 



Use the IDENTIFY command to display or stack the 
following information: your userid, the date, time, and 
day of the week. 

The format of the IDENTIFY command is: 



IDentify 


[(options. ..[)]] 




options: 






STACK [FIFOlLIFO] 

FIFO 

LIFO 

TYPE 








L. —1 



Options: 



STACK FIFOlLIFO 

specifies that the information should be placed 
in the program stack rather than displayed at 
the terminal. The information is stacked either 
FIFO (first in first out) or LIFO (last in first 
out). The default order is FIFO. 



FIFO 



specifies that the information should be placed 
in the program stack rather than displayed at 
the terminal. The information is stacked FIFO. 
The options STACK, STACK FIFO, and FIFO 
are all equivalent. 



LIFO 



specifies that the information should be placed 
in the program stack rather than displayed at 
the terminal. The information is stacked LIFO. 
This option is equivalent to STACK LIFO. 
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TYPE 

specifies that the information should be 
displayed at the terminal. This is the default 
option. 

Responses: The following information is displayed or 
stacked: 



user id AT 5s VIA " date time zone day 



Where: 



user id 

is the userid of your virtual machine. 



is a token placeholder representing the RSCS 
node id, which is not supported in VM/PC. 



is a token placeholder representing the userid of 
the RSCS virtual machine, which is not 
supported in VM/PC. 

date 

is the local date, in the form mm/dd/yy. 

t ime 

is the local time, in the form hh:mm:ss. 

zone 

is the word LOCAL. 

day 

is the day of the week. 
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Implementation Notes: The userid and node are from 
the CP QUERY USERID command. The date and 
time are from the CP QUERY TIME command. 

IDENTIFY keeps some of its information in storage, 
such as userid. To change any of that information, you 
must issue NUCXDROP IDENTIFY and then reissue 
the IDENTIFY command. 

Error Messages and Return Codes: 

DMSIDE003E INVALID OPTION 'nn' RC=24 
DMSIDE070E INVALID PARAMETER 'nn' RC=24 
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IMMCMD 



Use the IMMCMD command to establish or cancel 
Immediate commands from within an EXEC. 
IMMCMD determines whether a particular Immediate 
command has been established or if it has been issued 
by the terminal user. 

The format of the IMMCMD command is: 



IMMCMD 


{ SET 


} 




{ CLEAR 


} name a 




{ QUERY 


} 




{ STATUS 


} 



For a complete description of the IMMCMD command, 
refer to the VM/SP CMS Command and Macro 
Reference, 
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IMPORT 



Use the IMPORT command to make a copy of a 
Personal Computer file on a CMS minidisk. The 
format of the IMPORT command is: 



IMPort 


d: f i lename.ext fn ft fm [(options. 


■.[>]] 




opt ions : 

[ REP or REPLACE 


] 




[ LRECL nnnn 


] 




[ ASCI 1 or NOASCI 1 


] 




[ EOL or NOEOL 


] 



Where: 



d : f i lename.ext 

is the filespec of the Personal Computer file to 
be imported. The drive and filename must be 
specified. The filename extension is optional. 
Remember to include the extension when you 
refer to a file that has an extension, otherwise 
VM/PC will be unable to locate the file. No 
special characters (?,*) are allowed in the 
filespec. 



fn 



ft 



fm 



is the filename of the CMS file to create. 



is the filetype of the CMS file to create. 



is the filemode of the CMS file to create. 



Note: You must specify a fn, ft, and fm when using 



tVip T1VTPORT rnmrnsmrl 
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REP or REPLACE 

Specifies that an existing CMS file with the 
fileid specified will be replaced with the 
specified Personal Computer file. 

LRECL nnnn 

Specifies the logical record length at which the 
Personal Computer file is to be read, and at 
which the CMS file will be written (default is 
80). 

ASCI I or NOASCI I 

ASCII specifies that the file is to be translated 
from ASCII to EBCDIC during the IMPORT. 
NO ASCII specifies that the file is not to be 
translated from ASCII to EBCDIC during the 
IMPORT. ASCII is the default. 

EOL or NOEOL 

EOL specifies that the source file is to be 
scanned for end-of-line characters (carriage 
return/line feed) which will be interpreted as 
end-of-line delimiters in creating the CMS file. 
NOEOL specifies that the source file is not to 
be scanned for end-of-line characters. In this 
case, the file created will be an F-format file. 
EOL is the default. 



Notes: 



If the EOL option is specified, the Personal 
Computer DOS file will be scanned up to the 
LRECL value for end-of-line characters. If no 
end-of-line characters are found before the LRECL 
value is reached, the error message: 

Import terminated, file ' d : f i lename.ext ' truncated 

is displayed, and the import is not done. The logical 
record length (either the default or user specified 
LRECL) must exceed the length of the largest line 
in the Personal Computer DOS file. 
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If the NOEOL option is specified to import a file, 
the CMS file will be an F-format file, with a logical 
record length equal to the LRECL used to import 
the file (either the default, 80, or a user specified 
LRECL). 

If end-of-file is detected prior to reading in this 
amount, then the CMS file created will have a 
logical record length equal to the amount read. 
Thus, if the Personal Computer file has 38 bytes, 
and is imported without specifying a LRECL value, 
the CMS file produced will have 38 bytes. 

If the last read of the Personal Computer file results 
in less than the LRECL amount of data, it will be 
padded with X'00' to the LRECL length, except in 
the case just noted. If a PC file with 100 bytes is to 
be imported, the resultant CMS file will have 2 
records of 80 bytes each, with the second record 
padded with xW to a length of 80. 

If the EOL option is used, the maximum LRECL 
value which may be specified is 65535. If the 
NOEOL option is used, the only restriction on the 
LRECL value is the size of your virtual machine, 
since an I/O buffer this size must be acquired. 

A file which has been exported, translated to 
ASCII, and subsequently imported may differ from 
the original file, due to the translate tables used in 
the file transformations. The NOASCII options 
should be used to avoid problems caused by this 
transformation. Appendix D, "ASCII to EBCDIC 
Conversion" on page D-l lists the EBCDIC- ASCII 
conversion tables which are used in this translation. 



7-140 VM/PC U ser s Guide 



Messages and Return Codes: 

DMSIMP002E File ' d : f ilename.ext ' not found RC=28 
DMSIMP003E Inval Id option 'option' RC=2*t 
DMSIMP02^E File 'fn ft fm 1 already exists — specify 

'replace' RC=28 
DMSIMP029E Invalid parameter 'parameter' in the option 

'option' field RC=24 
DMSIMP037E Disk 'mode' is read/only RC=36 
DMSIMP0^2E No fileid(s) specified RC=24 
DMSIMP048E Invalid mode 'mode' RC=2*+ 
DMSIMP054E Incomplete fileid specified RC=24 
DMSIMP062E Invalid * in fileid RC=20 
DMSIMP070E Inval id parameter 'parameter' KZ=2k 
DMSIMP105E Error 'nn' writing file 'fn ft fm' on disk RC=100 
DMSIMP622E Insufficient storage ava i lable RC=41 
DMSIMP804E Invalid PC fileid ' d: f i lename.ext ' RC=20 
DMSIMP805E Import terminated, file 'd: fi lename.ext ' 

truncated RC=100 
DMSIMP807S Drive d not ready. Make drive ready and press enter 
DMSIMP907E I/O error on file 'd: f i lename.ext ' RC=256 
DMSSTT048E Invalid mode 'mode' RC=2^ 

DMSSTT062E Invalid character 'char' in fileid 'fn ft fm' RC=20 
DMSSTT069E Disk 'mode' not accessed RC=36 
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INCLUDE 



Use the INCLUDE command to read one or more 
TEXT files (containing relocatable object code) from 
disk and to load them into virtual storage, establishing 
the proper linkages between the files. A LOAD 
command must have been previously issued for the 
INCLUDE command to produce desirable results. For 
information on the CMS loader and the handling of 
unresolved references, see the description of the LOAD 
command. The format of the INCLUDE command is: 



INclude 



f n . . . [ (opt ions ...[)]] 
opt ions: 

" '"reset 



[CLEAR 1 ("RESET ientryfl [ORIGIN JhexlocH 
[noclearj [ < * )j L I TRANS U 

[map 1 [type ~|Qnv 1 [rep 1 [auto 1 
[nomapj [ notypeJ [_noinvJ [norepJ [noautoJ 

[LIBE 1 [START] [SAME] [dUP 1 [RLDSAVE] 

JnolibeJ [nodupJ 



The RLDSAVE option controls whether the CMS 
loader saves relocation information in an internal buffer 
as the text files are loaded. If this information is saved, 
the GENMOD command will append it to the CMS 
module when it is created. This information is used by 
the NUCXLOAD command, if the module is loaded as 
a nucleus extension, to relocate the module to the area 
where it has been loaded. 

For a complete description of the INCLUDE 
command, refer to VM/SP CMS Command and Macro 
Reference. 
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LISTFILE 



Use the LISTFILE command to obtain specified 
information about CMS files residing on accessed disks. 
The format of the LISTFILE command is: 



Listf i le 



[ f C [ f £ [ f T]l] [ (options...[)]] 



opt ions : 



Header 
|_NOHeaderJ 



*Exec[Trace][ARGS]" 
Trace [ARGS] 
APpend [ARGS] 
STACK [ FIFO lLIFOl 
FIFO 
LIFO 
XEDIT 



"FName " 
FType 
FMode 
FOrmat 
ALloc 
Date 
LABEL 



[Blocks] 
[%x ] 



For a complete description of the LISTFILE command, 
refer to the VM/SP CMS Command and Macro 
Reference. 
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LOAD 



Use the LOAD command to read one or more TEXT 
files (containing relocatable object code) from disk and 
to load them into virtual storage, establishing the proper 
linkages between the files. The format of the LOAD 
command is: 



LOAD 



fn .. 
opt ions : 



[(options. ..[)]] 



[CLEAR 1 [RESET JentryH [ORIGIN A 
[NOCLEARj [ / * ) ] L /TRANS 

[map ITtype "iriNv 1 Trep 1 [auto 1 
[nomap] [notype] [noinv] [norepj LnoautoJ 



1] 



[ ll BE 1 [START] TdUP 1 [RLDSAVE] 

[noli be] [nodupJ 



The RLDSAVE option controls whether the CMS 
loader saves relocation information in an internal buffer 
as the text files are loaded. If this information is saved, 
the GENMOD command will append it to the CMS 
module when it is created. This information is used by 
the NUCXLOAD command, if the module is loaded as 
a nucleus extension, to relocate the module to the area 
where it has been loaded. 

For a complete description of the LOAD command, 
refer to the VM/SP CMS Command and Macro 
Reference. 
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LOADMOD 



Use the LOADMOD command to load a MODULE 
file into storage. The file must be in the format which 
is created by the GENMOD command. The format of 
the LOADMOD command is: 



LOADMod 


fn ["MODULE 


"fml" 
_* J. 





Where: 

fn 

is the filename of the file to be loaded into 
storage. The filetype must be MODULE. 

fm 

is the filemode of the module to be loaded. If 
not specified, or specified as an asterisk, all your 
disks are searched for the file. 

Usage Note: 

You can use the LOADMOD command when you want 
to debug a CMS MODULE file. After the file is 
loaded, you may set address stops or breakpoints before 
you begin execution with the START command; for 
example: 

loadmod progl 

cp trace i 210ae.4 

start 
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Responses: None. 
Messages and Return Codes: 



DMSM0D001E NO FILENAME SPECIFIED RC=24 

DMSM0D002E FILE ' f n ft' NOT FOUND RC=28 

DMSMOD032E INVALID FILETYPE 'ft' RC=24 

DMSMOD070E INVALID PARAMETER 'parameter' RC=24 

DMSM0D104S ERROR 'nn' READING FILE 'fn ft fm' FROM DISK RC=100 

DMSMOD109S VIRTUAL STORAGE CAPACITY EXCEEDED RC=104 

DMSMOD116S LOADER TABLE OVERFLOW RC=104 

DMSSTT048E INVALID MODE 'mode' RC=2*4 

DMSSTT062E INVALID CHARACTER 'character' IN FILE ID 'fn ft fm' RC=20 
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MACLIB 



Use the MACLIB command to create and modify CMS 
macro libraries. The format of the MACLIB command 
is: 



MAC 1 i b 


/ (GEN/ 


\ 








</\DD> 


1 i bname f n1 [f n2. . . ] 








(REP) 








< 


DEL 1 

COMP 1 

, MAP 1 


ibname membernamel [member name 2. . . ] 

i bname 

ibname [ (opt ions ...[)] ] , 


> 






opt ions : 










["TERM 1 












DISK 












LprintJ 







For a complete description of the MACLIB command, 
refer to the VM/SP CMS Command and Macro 
Reference. 
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MAKEBUF 



Use the MAKEBUF command to create a new buffer 
within the program stack. The format of the 
MAKEBUF command is: 



MAKEBUF 



Usage Notes: 

1 . When you issue a MAKEBUF command, CMS 
returns as a return code the number of the program 
stack buffer just created. If you issue a MAKEBUF 
command in an EXEC that has the &ERROR 
statement in effect, the MAKEBUF return code 
causes the &ERROR statement to execute. 

2. Use the WAITRD function to read lines from the 
buffers the MAKEBUF command creates. 
WAITRD first reads lines from the most recently 
created buffer. When the most recent buffer is 
exhausted, WAITRD reads the next most recent 
buffer. When all program stack buffers are 
exhausted, WAITRD reads from the terminal input 
buffer. 
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MODMAP 



Use the MODMAP command to display the load map 
associated with the specified MODULE file. The 
format of the MODMAP command is: 



MODmap 



fn 



For a complete description of the MODMAP 
command, refer to the VM/SP CMS Command and 
Macro Reference. 



NUCXDROP 



Use the NUCXDROP command to cancel nucleus 
extensions and release the storage occupied by the 
corresponding program. The NUCXDROP command 
uses the NUCEXT function which is described in detail 
in the Function section of the publication VM/SP CMS 
Command and Macro Reference. 

The command format is: 



NUCXDROP 



M 



amel name2. . 



Note: In VM/PC, the NUCXDROP * command 
cannot be used with EXECs or XEDIT macros. If the 
filetype is EXEC or XEDIT it must be specifically 
named. 

For a complete description of the NUCXDROP 
command, refer to the VM/SP CMS Command and 
Macro Reference. 
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NUCXLOAD 



Use NUCXLOAD to install nucleus extensions. The 
command loads either an ADCON-free and serially 
reusable module or a relocatable module into free 
storage and installs it as a nucleus extension. The 
nucleus extension is invoked by issuing the name of the 
nucleus extension. The NUCXLOAD command uses 
the NUCEXT function which is described in detail in 
the Function section of the publication VM/SP CMS 
Command and Macro Reference. 

The format of the command is: 



NUCXLOAD 



name [fn] ([SYstem] [SErvice] 
[ENdcmd] [IMmcmd] [Push] [] 



where: 



name fn 

'name' is the name associated with this nucleus 
extension, 'fn' is the optional filename of a 
module file to be loaded and associated with 
'name'. The module being loaded must be 
either an ADCON-free and serially reusable 
module or a relocatable module. The term 
ADCON-free implies that the program needs no 
relocation, that is, it runs correctly when loaded 
at an address different from that at which it was 
generated (via GENMOD). It allows the object 
module to be read directly into storage obtained 
from the free storage manager, after 
determining the size needed from the module 
header (or the file format, for the one-record 
fixed format CMS system transient routines). 
The term serially reusable implies that the same 
copy of a routine may be used by another task 
after the current use has been concluded. If 
the second argument (fn) is not specified, the 
command name is also used as the filename of 
the module. 
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SYstem 

indicates that system free storage should be 
used, and the program is to receive control 
disabled, key 0. The SYSTEM option is 
assumed by default for transient routines 
generated with the SYSTEM option of the 
GENMOD command. 

SErvice 

indicates that service calls are accepted (for 
instance a PURGE from an abend). 

ENdcmd 

indicates that the nucleus extension receives 
control at normal end-of-command processing. 

I Mmcmd 

indicates that this nucleus extension can be 
invoked as an Immediate command. 

Push 

causes no check to be made to see if there is 
already a nucleus extension of the same name. 
Otherwise, an existing nucleus extension is not 
overridden. 

Return codes: 

10 - Invalid argument list on command 

21 - Length mismatch when reading module 

22 - Invalid format for RLD record 

23 - A Y-CON RLD entry was found which could not be relocated 

31 _ Insufficient preallocated storage available to load module 

32 - Storage not available for header record buffer 

33 " Storage not available to load the module 

34 - Storage not available for RLD record buffer 
k] - Nucleus Extension of same name already exists 

l \xx - FSSTATE error ("xx" is FSSTATE return code) 

5xx - Error reading module header record ("xx" is FSREAD return code) 

6xx - Error reading module code ("xx" is FSREAD return code) 

7xx - Error reading RLD record ("xx" is FSREAD return code) 

8xx - Error from NUCEXT ("xx" is NUCEXT return code) 
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NUCXMAP 



Use the NUCXMAP command to get information 
about the currently defined nucleus extensions. 
NUCXMAP displays on the console or stacks a list of 
the nucleus extensions. The NUCXMAP command 
uses the NUCEXT function which is described in detail 
in the Function section of the VM/SP CMS Command 
and Macro Reference. 

The command format is: 



NUCXMAP 


[ALL] [([STACK 


"lifo" 

FIFO 


[)]]] 



For a complete description of the NUCXMAP 
command, refer to the VM/SP CMS Command and 
Macro Reference. 
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PRINT 



Use the PRINT command to print a CMS file on the 
spooled printer. The format of the PRINT command is: 



PRint 



fn ft ffml [(options. ..[)]] 



options 

CC [ 
NOCC 



CC [HEADerfl 

NOCC J [UPCASE] 

[LINECOUN nnllMEMBER \ * [1 
L ££_IL (member name) J 



[! 



[TRC 1 

[ notrcJ 



[HEX] 



For a complete description of the PRINT command, 
refer to the VM/SP CMS Command and Macro 
Reference. 
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QUERY 



Use the QUERY command to gather information about 
your CMS virtual machine. You can determine: 

• The state of virtual machine characteristics that are 
controlled by the CMS SET command 

• File definitions (set with the FILEDEF command) 
that are in effect 

• The status of accessed disks 

The format of the QUERY command is: 



Query 



/ LDRTBLS 
RELPAGE 
IMPCP 
IMPEX 
ABBREV 
INPUT 
OUTPUT 
SEARCH 



DISK 



SYNONYM 



FILEDEF 

MACLIB 

TXTLIB 

L I BRARY 

CMSLEVEL 

CMSTYPE 

IMESCAPE 

EXECTRAC 

OSSIM 



mode 

R/W 
MAX 

SYSTEM 

USER 

ALL 



(opt ions. . . ) 



Options : 



STACK 

FIFO 

LIFO 



FIFO 
LIFO 
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Operands for Functions that Can Be Controlled Via 
the SET Command: 

LDRTBLS 

displays the number of loader tables. 



Response: LDRTBLS = nn 

RELPAGE 

indicates whether pages of storage are to be 
released or retained after certain commands 
complete execution. 



Response: 

RELPAGE = {ON } 
(OFF) 



Where: 

ON 

releases pages. 

OFF 

retains pages. 

IMPCP 

displays the status of implied CP command 
indicator. 



Response: 

IMPCP = {ON } 
{OFF} 



Where: 

ON 

indicates that CP commands can be entered 
from the CMS environment. 

OFF 

indicates that you must use the CP command or 
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the #CP function to enter CP commands from 
the CMS environment. 

IMPEX 

displays status of implied EXEC indicator. 

Response: 

IMPEX = {ON } 
{OFF} 

Where: 

ON 

indicates that EXEC files can be executed by 
entering the filename of the file. 

OFF 

indicates that the EXEC command must be 
explicitly entered to execute EXEC files. 

ABBREV 

displays the status of the minimum truncation 
indicator. 



Response: 

ABBREV = {ON } 
{OFF} 



Where: 

ON 

indicates that truncations are accepted for CMS 
commands. 

OFF 

indicates that truncations are not accepted. 

INPUT 

displays the contents of any input translate table 
in effect. 
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Response: 

INPUT a1 xx1 



an xxn 

If you do not have an input translate table in effect, the 
response is: 

NO USER DEFINED INPUT TRANSLATE TABLE IN USE 

OUTPUT 

displays the contents of any output translate 
table in effect. 



Response: 

OUTPUT xx 1 a1 



xxn an 

If you do not have an output translate table defined, the 
response is: 

NO USER DEFINED OUTPUT TRANSLATE TABLE IN USE 

Operands for CMS Disk Status Functions: 

SEARCH 

displays the search order of all disks currently 
accessed. 



Response: 

label cuu mode {R/0} 
{R/W} 
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Where: 



label 

is the label assigned to the disk when it was 
formatted; or, if it is an OS or DOS disk, the 
volume label. 

cuu 

is the virtual device address. 

mode 

is the filemode letter assigned to the disk when 
it was accessed. 

{R/0} 
(R/W) 

indicates whether read/write or read-only is the 

status of the disk. 

DISK mode 

displays the status of the single disk represented 
by "mode." 



Response: 



LABEL CUU M STAT CYL TYPE BLKSIZE FILES BLKS USED-(%) BLKS LEFT BLK TOTAL 
label cuu m {R/0} FB type blksize nnnn nnnn-nn nnnn nnnnn 
{R/W} 

Where: 

label 

is the label assigned to the disk when it was 
formatted. 

cuu 

is the virtual device address. 

m 

is the access mode letter. 

{R/0} STAT 

indicates whether read/write or read-only 

{R/W} 

is the status of the disk. 
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cy I 

is the number of cylinders available on the disk. 
For an FB-512 device, this field contains the 
notation 'FB' rather than the number of 
cylinders. 

type 

is the device type of the disk or the designation 
drive id: PC if the minidisk is on a local 
Personal Computer disk. 

blks ize 

is the CMS disk block size when the minidisk 
was formatted. 

nnnn FILES 

is the number of CMS files on the disk. 

nnnn BLKS USED 

indicates the number of CMS disk blocks in use. 

nn 

indicates the percentage of blocks in use. 

nnnn BLKS LEFT 

indicates the number of disk blocks left. This is 
a high approximation because control blocks are 
included. 

nnnnn BLK TOTAL 

indicates the total number of disk blocks. 

If the disk with the specified mode is not accessed, the 
response is: 

DISK 'mode' NOT ACCESSED 

DISK * 

displays the status of all CMS disks. 

Response: Is the same as for QUERY DISK mode; one 
line is displayed for each accessed disk. 

DISK R/W displays the status of all CMS disks that 
have been accessed in the Read/Write mode. 
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Response: Is of the same format as QUERY DISK 
mode; one header is displayed followed by one line for 
each accessed CMS Read/Write disk. 

DISK MAX displays the status of the CMS disk 
accessed in Read/Write mode having the most available 
space. 

Response: Is of the same format as QUERY DISK 
mode; a header and one line are displayed for the CMS 
Read/Write disk with the most available space. 

Other Functions: "SYNONYM SYSTEM" displays 
the CMS system synonyms in effect. 

Response: 

SYSTEM SHORTEST 
COMMAND FORM 



command minimum truncation 



If no system synonyms are in effect, the following 
message is displayed at the terminal: 

NO SYSTEM SYNONYMS IN EFFECT 

SYNONYM USER 

displays user synonyms in effect. 

Response: 

SYSTEM USER SHORTEST 

COMMAND SYNONYM FORM (IF ANY) 

command synonym minimum truncation 



If no user synonyms are in effect, the following 
message is displayed at the terminal: 

NO USER SYNONYMS IN EFFECT 
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SYNONYM ALL 

displays all synonyms in effect. 

Response: The response to the command QUERY 
SYNONYM SYSTEM is followed by the response to 
QUERY SYNONYM USER. 

FILEDEF 

displays all file definitions in effect. 

Response: 

[ddname device [fn [ft]] 



If no file definitions are in effect, the following message 
is displayed at the terminal: 

NO USER DEFINED FILEDEF'S IN EFFECT 

MACLIB 

displays the names of all files, with a filetype of 
MACLIB, that are to be searched for macro 
definitions (that is, all MACLIBs specified on 
the last GLOBAL MACLIB command, if any). 

Response: MACL I B = 1 1 bname . . . 

If no macro libraries are to be searched for macro 
definitions, the response is: 

MACLIB = NONE 

TXTL I B 

displays the names of all files, with a filetype of 
TXTLIB, that are to be searched for unresolved 
references (that is, all TXTLIBs specified on 
the last GLOBAL TXTLIB command, if any). 
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Response: TXTL I B = 1 i bname . . . 

If no TXTLIBs are to be searched for unresolved 
references, the following message is displayed at the 
terminal: 

TXTL IB = NONE 



LIBRARY 

displays the names of all library files with 
filetypes of MACLIB and TXTLIB that are to 
be searched. 

Response: 

MACLIB = {li bname...} 
{NONE } 

TXTLIB = {libname...} 
{NONE } 

CMSLEVEL returns the feature or program product, 
release, and the service level of CMS. 

Response: Displays the VM/PC Service Level. 

For example: VM/PC Version 2.00, Service Level 

4275 

CMSTYPE indicates the status of the CMS terminal 
display. This option is valid only from an EXEC 
environment. 

CMSTYPE = RT 

or 
CMSTYPE = HT 

IMESCAPE displays the immediate command escape 
character. If there is no escape character in effect, the 
response is IMESCAPE=OFF. If one is in effect, the 
response is IMESCAPE=char, where char is the escape 
character. The default escape character is a semi-colon 
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EXECTRAC displays the setting of the tracing bit (in 
EXECFLAG in NUCON). Response is either 
EXECTRAC=ON or EXECTRAC=OFF. 

OSSIM displays whether the OS Simulation 
environment is available for use. 

STACK 

causes the results of the QUERY command to 
be placed in the program stack instead of being 
displayed at the terminal. The information is 
stacked either FIFO (first-in first-out) or LIFO 
(last-in first-out). The default order is FIFO. 

If CMS passes the command to CP, then the 
response from CP is also put in the program 
stack. If CP precedes the QUERY command, 
CMS does not stack the results. The STACK 
option is valid only when issued from CMS. 

FIFO 

(first-in first-out) is the default option for 
STACK. FIFO causes the results of the 
QUERY command to be placed in the program 
stack instead of being displayed at the terminal. 
The information is stacked FIFO. The options 
STACK, STACK FIFO, and FIFO are all 
equivalent. 

LIFO 

(last-in first-out) causes the results of the 
QUERY command to be placed in the program 
stack instead of being displayed at the terminal. 
The information is stacked LIFO. This option 
is equivalent to STACK LIFO. 

Usage Notes: 

1 . You may specify only one QUERY parameter at a 
time. 

2. If the implied CP (IMPCP) function is in effect and 
you enter an invalid QUERY parameter, you may 
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receive the message DMKCQR026E - OPERAND 
MISSING OR INVALID. 

3. If an invalid QUERY parameter is specified from an 
EXEC and the implied CP (IMPCP) function is in 
effect, then the return code is -0003. 

( 

4. When the STACK option is specified, the header is 
included in the program stack. 

Error Messages and Return Codes: 

DMSQRY005E NO 'option' SPECIFIED RC=24 

DMSQRYOHfE INVALID FUNCTION 'function' RC=24 

DMSQRY026E INVALID PARAMETER 'parameter' FOR' function' FUNCTION RC=24 

DMSQRY047E NO FUNCTION SPECIFIED RC=24 

DMSQRY070E INVALID PARAMETER 'parameter' RC=24 
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RELEASE 



Use the RELEASE command to free an accessed disk 
and make the files on it unavailable. The format of the 
RELEASE command is: 



RELease 



S cuu | 
I mode ) 



[(det[)]; 



For a complete description of the RELEASE command, 
refer to the VM/SP CMS Command and Macro 
Reference. 



RENAME 



Use the RENAME command to change the fileid of 
one or more CMS files on a read/ write CMS disk. The 
format of the RENAME command is: 



Rename 


fileid! f i 


leid2 [(options. ..[)]] 

opt ions : 

[TYPE IfUPDIRT 1 
1 NOTYPE II NOUPDIRTj 



For a complete description of the RENAME command, 
refer to the VM/SP CMS Command and Macro 
Reference. 
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RESERVE 



Use the RESERVE command to allocate all available 
blocks of a 5 12-, IK- , 2K-, or 4K-byte block formatted 
minidisk to a unique CMS file. 

The format of the RESERVE command is: 



RESERVE 



[fn ft fm] 



RESERVE returns these completion codes in Register 
15: 

• - DASD reserved for the specified filename 
filetype filemode. 

• 16 - Disk not formatted properly (must be 512, 
1024, 2048, or 4096 blocksize). 

• 24 - No fileid was specified with the command. 

• 36 - Disk not accessed or read-only. 

• 100 - Permanent I/O error. 

• 104 - Not enough storage to process the command. 

For a complete description of the RESERVE 
command, refer to the VM/SP CMS Command and 
Macro Reference. 
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SENTRIES 



Use the SENTRIES command to determine the number 
of lines currently in the program stack. When you issue 
a SENTRIES command, CMS returns the number of 
lines in the program stack (but not the terminal input 
buffer) as a return code. The format of the SENTRIES 
command is: 



SENTRIES 



Usage Note: If you issue a SENTRIES command in an 
EXEC that has set up a procedure to be done when an 
error occurs, a nonzero SENTRIES return code causes 
that procedure to execute. 
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SET 



Use the SET command to establish, turn off, or reset a 
particular function in your CMS virtual machine. Only 
one function may be specified per SET command. The 
format of the SET command is: 



SET 


f unct ion 




f unct ions : 




[LDRTBLS nn]fRELPAGE ON*] ["OSSIM ON 1 

Lrelpage offJ Loss i m offj 




TABBREV ON 1 flMPEX ON 1 [INPUT f a xxll 
LABBREV OFFJLIMPEX OFFJ L L xx yyJJ 




TlMPCP ON 1 [CMSTYPE (HTH [OUTPUT [xx a]l 

Limpcp offJ L Jrtj J 






'IMESCAPE ON 
IMESCAPE OFF 
JMESCAPE char 


Texectrac on "1 
Lexectrac offj 




} 


Vhere functions 





LDRTBLS nn 

defines the number (nn) of pages of storage to 
be used for loader tables. By default, a virtual 
machine having up to 384K of addressable real 
storage has two pages of loader tables; a larger 
virtual machine has three pages. Each loader 
table page has a capacity of 204 external names. 
During LOAD and INCLUDE command 
processing, each unique external name 
encountered in a TEXT deck is entered in the 
loader table. The LOAD command clears the 
table before reading TEXT files; INCLUDE 
does not. This number can be changed with the 
SET LDRTBLS nn command provided that: (1) 
nn is a decimal number between 1 and 127, 
inclusive, and (2) the virtual machine has 
enough storage available to allow nn pages to be 
used for loader tables. If these two conditions 
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are met, nn pages are set aside for loader tables. 
If you plan to change the number of pages 
allocated for loader tables, you should 
deallocate storage at the high end of storage so 
that the storage for the loader tables may be 
obtained from that area. Usually, you can 
deallocate storage by releasing one or more of 
the disks that were accessed. 

RELPAGE ON 

releases page frames of storage and sets them to 
binary zeros after the following commands 
complete execution: COPYFILE, COMPARE, 
MACLIB, SORT, TXTLIB, UPDATE, and the 
program product language processors supported 
by VM/PC. 

RELPAGE OFF 

does not release pages of storage after the 
commands listed in the RELPAGE ON 
description complete execution. Use the SET 
RELPAGE OFF function when debugging or 
analyzing a problem so that the storage used is 
not released and can be examined. 

OSS IM ON 

loads the OSSIM module into CMS free storage 
to provide the services of OS Simulation. This 
command is normally used in the SYSPROF 
exec (system profile exec) which is normally 
executed when CMS is started. 

OSSIM OFF 

may be used to unload the OS Simulation 
services of CMS. 

INPUT a xx 

translates the specified character "a" to the 
specified hexadecimal code "xx" for characters 
entered from the terminal. 



Chapter 7. VM/PC Commands 7-169 



INPUT xx yy 

allows you to reset the hexadecimal code "xx" 
to the specified hexadecimal code "yy" in your 
translate table. 

Note: If you issue SET INPUT and SET 
OUTPUT commands for the same characters, 
issue the SET OUTPUT command first. 

INPUT 

returns all characters to their default translation. 

OUTPUT xx a 

translates the specified hexadecimal 
representation "xx" to the specified character 
"a" for all "xx" characters displayed at the 
terminal. 

OUTPUT 

returns all characters to their default translation. 

Note: Output translation does not occur for 
SCRIPT files when the SCRIPT command 
output is directed to the terminal, nor when you 
use the CMS editor on a display terminal in 
display mode. 

ABBREV ON 

accepts system and user abbreviations for 
system commands and EXECs. The 
SYNONYM command makes the system and 
user abbreviations available. 

ABBREV OFF 

accepts only the full system command name or 
the full user synonym (if one is available) for 
system commands. Both synonyms and 
truncations for EXECs are ignored. 

For a discussion of the relationship of the SET 
ABBREV and SYNONYM commands, refer to 
the SYNONYM command description. 
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IMPEX ON 

treats EXEC files as commands; an EXEC file 
is invoked when the filename of the EXEC file 
is entered. 

IMPEX OFF 

does not consider EXEC files as commands. 
You must issue the EXEC command to execute 
an EXEC file. 

IMPCP ON 

passes command names that CMS does not 
recognize to CP; that is, unknown commands 
are considered to be CP commands. 

IMPCP OFF 

generates an error message at the terminal if a 
command is not recognized by CMS. 

CMSTYPE HT 

suppresses CMS terminal display within an 
EXEC. All CMS terminal display from an 
EXEC, except for CMS error messages with a 
suffix letter of 'S' or T\ is suppressed until the 
end of the EXEC file or until a SET 
CMSTYPE RT command is executed. 

CMSTYPE RT 

resumes CMS terminal display which has been 
suppressed as a result of a previous SET 
CMSTYPE HT command. 

IMESCAPE ON 

indicates an escape character is required to 
execute immediate commands. The default 
escape character is a semi-colon (;). 

IMESCAPE OFF 

indicates an escape character is not required to 
execute immediate commands. This is the 
default setting. 

IMESCAPE char 

indicates an escape character is required to 
execute immediate commands. The escape 
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character is a single character and it cannot be 
A-Z or 0-9. 

EXECTRAC ON 

specifies that you want tracing turned on for 
your System Product Interpreter or EXEC 2 
program. The tracing bit in the EXECFLAG in 
NUCON is turned on. 

EXECTRAC OFF 

specifies that you want tracing turned off for 
your System Product Interpreter or EXEC 2 
program. 

Note: &STACK HT and SET CMSTYPE HT have the 
same effect when interpreted by the CMS EXEC 
processor. Similarly, &STACK RT and SET 
CMSTYPE RT are equivalent for the CMS EXEC 
processor. However, when using EXEC 2, the 
commands &STACK HT and &STACK RT cause the 
characters "HT" and "RT" to be placed in the program 
stack and do not affect the console output. These 
characters must be used by a program or cleared from 
the stack. Otherwise, you will receive an "UNKNOWN 
CP/CMS COMMAND" error message when they are 
read from the program stack. 

Usage Notes: 

1 . If you issue the SET command specifying an invalid 
function and the implied CP function is in effect, 
you may receive message DMKCFS026E 
OPERAND MISSING OR INVALID. 

2. If an invalid SET command function is specified 
from an EXEC and the implied CP function is in 
effect, then the return code is -0003. 



3. To determine or verify the setting of most 
functions, use 1 

Responses: None. 



functions, use the QUERY command. $ 

si 
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Messages and Return Codes: 



DMSLI0002I FILE 'fn' TXTL I B NOT FOUND RC=0 

DMSSET014E INVALID FUNCTION 'function' RC=2*4 

DMSSET026E INVALID PARAMETER 'parameter' FOR 'function' FUNCTION RC=24 

DMSSET031E LOADER TABLES CANNOT BE MODIFIED RC=40 

DMSSET047E NO FUNCTION SPECIFIED RC=24 

DMSSET0^+8E INVALID MODE 'mode' RC=24 

DMSSET050E PARAMETER MISSING AFTER 'function' RC=24 

DMSSET061E NO TRANSLATION CHARACTER SPECIFIED RC=24 

DMSSET070E INVALID PARAMETER 'parameter' RC=24 

DMSSET098W CMS OS SIMULATION NOT AVAILABLE RC=4 

DMSSETIOOW SYSTEM NAME 'name' NOT AVAILABLE RC=4 
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SORT 



Use the SORT command to read fixed-length records 
from a CMS input file, arrange them in ascending 
EBCDIC order according to specified sort fields, and 
create a new file containing the sorted records. The 
format of the SORT command is: 



SORT 



fileidl file?d2 



For a complete description of the SORT command refer 
to the VM/SP CMS Command and Macro Reference 
publication. 

For an example of using the SORT command, see 
"CMS SORT Command" on page 5-27. 



START 



Use the START command to begin execution of CMS 
programs that were previously loaded. The format of 
the START command is: 



START 


entry [args...] 
(option [)] 


opt ion : 
NO 



For a complete description of the START command, 
refer to the VM/SP CMS Command and Macro 
Reference. 
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STATE/STATEW 



Use the STATE command to verify the existence of a 
CMS file on any accessed disk; use the ST ATE W 
command to verify the existence of a CMS file on any 
accessed read/write disk. The formats of the STATE 
and ST ATE W commands are: 



J STATE I 
/STATEVM 



mmm 



For a complete description of the STATE/STATEW 
command, refer to the VM/SP CMS Command and 
Macro Reference. 



Chapter 7. VM/PC Commands 7-175 



SYNONYM 



Use the SYNONYM command to invoke a table of 
synonyms to be used with, or in place of, CMS and 
user-written command names. You create the table 
yourself using an editor. The form for specifying the 
entries for the table is described under 'The Synonym 
Table." 

The names you define can be used either instead of or 
in conjunction with the standard CMS command 
truncations. However, no matter what truncations, 
synonyms, or truncations of the synonyms are in effect, 
the full real name of the command is always accepted. 
The format of the SYNONYM command is: 



SYNonym 



fn 



SYNONYM 



opt ions : 



m 



[std 1 [clear] 
[nostdj 



[(options. ..[)]] 



[user 1 
LsystemJ 



Where: 



fn 



fm 



is the filename of the file containing your 
synonyms table. 



is the filemode of the file containing your 
synonyms; if omitted, your A-disk and its 
extensions are searched. If you specify fm, you 
must enter the keyword, SYNONYM. If you 
specify fm as an asterisk (*), all disks are 
searched for the specified SYNONYM file. 
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Options: 

STD 

specifies that standard CMS abbreviations are 
accepted. 

NOSTD 

standard CMS abbreviations are not to be 
accepted. (The full CMS command and the 
synonyms you defined can still be used.) 

CLEAR 

removes any synonym table set by a previously 
entered SYNONYM command. 

USER 

specifies that the user synonym table is to be 
modified. 

SYSTEM 

specifies that the system synonym table is to be 
modified. 

Usage Notes: 

1 . If you enter the SYNONYM command with no 
operands, the system synonym table and the user 
synonym table (if they exist) are listed. 

2. The SET ABBREV ON or OFF command, in 
conjunction with the SYNONYM command, 
determines which standard and user-defined forms 
of a particular CMS command are acceptable. 

3. EXEC procedures having a synonym defined for 
them can be invoked by its synonym if implied 
EXEC (IMPEX) function is on. However, within 
an EXEC procedure, only the EXEC filename can 
be used. A synonym is not recognized within an 
EXEC since the synonym tables are not searched 
during EXEC processing. 

4. When ABBREV is OFF, the synonyms or 
truncations defined for EXECs are ignored. 
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The Synonym Table: You create the synonym table 
using an editor. The table must be a file with the 
filetype SYNONYM. The file consists of 80-byte 
fixed-length records in free-form format with columns 
73-80 ignored. The format for each record is: 

systemcommand usersynonym count 

Where: 

systemcommand 

is the name of the CMS command or MODULE 
or EXEC file for which you are creating a 
synonym. 

usersynonym 

is the synonym you are assigning to the 
command name. When you create the 
synonym, you must follow the same syntax rules 
as for commands; that is, you must use the 
character set used to create commands, the 
synonym may be no longer than eight 
characters, and so on. 

count 

is the minimum number of characters that must 
be entered for the synonym to be accepted by 
CMS. If omitted, the entire synonym must be 
entered (see the following example). 

A table of command synonyms is built from the 
contents of this file. You may have several synonym 
files but only one may be active at a time. For example, 
if the synonym file named MYSYN contains: 

COPYFILE CPY 

then, after you have issued the command: 

synonym mysyn 

the synonym CPY can be entered as a command name 
to execute the COPYFILE command. It cannot be 
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truncated since no count is specified. If MYSYN 
SYNONYM contains: 

ACCESS GETDISK 3 

then, the synonyms GET, GETD, GETDI, GETDIS, or 
GETDISK can be entered as the command name 
instead of ACCESS. 

If you have an EXEC file named TDISK, you might 
have a synonym entry: 

TDISK TDISK 2 

so that you can invoke the EXEC procedure by 
specifying the truncation TD. 

The Relationship between the SET ABBREV and 
SYNONYM Commands: This section applies only to 
system commands and not to EXECs. To find out if a 
command is an EXEC procedure, see CMS Command 
and Macro Reference. 

The default values of the SET and SYNONYM 
commands are such that the system synonym 
abbreviation table is available unless otherwise 
specified. 

The system synonym abbreviation table for the 
FILEDEF command states that FI is the minimum 
truncation. Therefore, the acceptable abbreviations for 
FILEDEF are: FI, FIL, FILE, FILED, FILEDE, and 
FILEDEF. The system synonym abbreviation table is 
available whenever both SET ABBREV ON and 
SYNONYM (STD) are in effect. 

If you have a synonym table with the file identification 
USERTAB SYNONYM A, that has the entry: 

FILEDEF USENAME 3 

then, USENAME is a synonym for FILEDEF, and 
acceptable truncations of USENAME are: USE, 



Chapter 7. VM/PC Commands 7-179 



USEN, USENA, USENAM, and USENAME. The user 
synonym abbreviation table is available whenever both 
SET ABBREV ON and SYNONYM USERTAB are 
specified. 

No matter what synonyms and truncations are defined, 
the full real name of the command is always in effect. 

A figure follows that lists the forms of the system 
command and user synonyms available for the various 
combinations of the SET ABBREV and SYNONYM 
commands. 

Responses: When you enter the SYNONYM command 
with no operands, the synonym table(s) currently in 
effect are displayed. 

SYSTEM USER SHORTEST 

COMMAND SYNONYM FORM (IF ANY) 



This response is the same as the response to the 
command QUERY SYNONYM ALL. 

DMSSYN711I NO SYSTEM SYNONYMS IN EFFECT 

This response is displayed when you issue the 
SYNONYM command with no operands after the 
command SYNONYM (NOSTD) has been issued. 

Other Messages and Return Codes: 

DMSSYN002E FILE 'fn ft fm' NOT FOUND RC=28 

DMSSYN003E INVALID OPTION 'option' RC=24 

DMSSYN007E FILE 'fn ft fm 1 NOT FIXED, 80 CHAR RECORDS RC=32 

DMSSYN032E INVALID FILETYPE 'ft' RC=24 

DMSSYN048E INVALID MODE 'mode' RC=24 

DMSSYN056E FILE 'fn ft fm' CONTAINS INVALID RECORD FORMATS RC=32 

DMSSYNO66E 'option AND 'option' ARE CONFLICTING OPTIONS RC=24 

DMSSYN104S ERROR 'nn' READING FILE 'fn ft fm' FROM DISK RC=100 
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Options 


Acceptable 
Command 
Forms 


Comments 


SET ABBREV ON 
SYN USERTAB (STD 


Fl 
FIL 

FILEDEF 

USE 

USEN 

USENAME 


The ABBREV ON option of the SET command and the 
STD option of the SYNONYM command make the sys- 
tem table available. The user synonym, USENAME, is 
available because the synonym table (USERTAB) is 
specified on the SYNONYM command. The trun- 
cations for USENAME are available because SET 
ABBREV ON was specified with the USERTAB also 
available. 


SET ABBREV OFF 
SYN USERTAB (STD 


FILEDEF 
USENAME 


The user-defined synonym, USENAME, is permitted 
because the user synonym table (USERTAB) is speci- 
fied on the SYNONYM command. No system or user 
truncations are permitted. 


SET ABBREV ON 

SYN USERTAB (NOSTD 


FILEDEF 

USE 

USEN 

USENAME 


The system synonym table is unavailable because the 
NOSTD option is specified on the SYNONYM com- 
mand. The user synonym, USENAME, is available 
because the user synonym table (USERTAB) is speci- 
fied on the SYNONYM command and the truncations 
of USENAME are permitted because SET ABBREV 
ON is specified with USERTAB also available. 


SET ABBREV OFF 
SYN USERTAB (NOSTD 


FILEDEF 
USENAME 


The system synonym table is made unavailable either 
by the SET ABBREV OFF command or by the SYN 
(NOSTD command. The synonym, USENAME, is 
permitted because the user-defined synonym table 
(USERTAB) is specified on the SYNONYM command. 
The truncations for USENAME are not permitted 
because the SET ABBREV OFF option is in effect. 


SET ABBREV ON 
SYN (CLEAR STD 


Fl 
FIL 

FILEDEF 


The user-defined table is now unavailable. The system 
synonym table is available because both the ABBREV 
ON option of the SET command and the STD option of 
the SYNONYM command are specified. 


SET ABBREV OFF 
SYN (CLEAR STD 

SET ABBREV ON 
SYN (CLEAR NOSTD 

SET ABBREV OFF 
SYN (CLEAR NOSTD 


FILEDEF 


Because CLEAR is specified on the SYNONYM com- 
mand, the synonym and its truncations are no longer 
available. Either the SET ABBREV OFF command or 
the SYNONYM (NOSTD command make the system 
synonym table unavailable. 



Figure 7-4. System and User-Defined Truncations 
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TXTLIB 



Use the TXTLIB command to update CMS text 
libraries. The format of the TXTLIB command is: 



TXTlib 



GEN libname fn1 [fn2 . ..] 
ADD 1 ibname fn1 [fn2 . . . ] 
DEL libname member name 1 [membername2 . 
MAP libname [ (opt ions ...[)] ] 
opt ions : 



TERM 
DISK 



PRINT 



TYPE 



For a complete description of the TXTLIB command, 
refer to the VM/SP CMS Command and Macro 
Reference. 



Use the TYPE command to display all or part of a CMS 
file at the terminal in either EBCDIC or the 
hexadecimal representation of the EBCDIC code. The 
format of the TYPE command is: 



Type 



fn ft [fm] 



opt ions : 



red 



recn 



[(options. . .[)] ] 



[HEX] ftOLUxxxxjf-yyyyy 11 ["MEMBER j* )1 



For a complete description of the TYPE command, 
refer to the VM/SP CMS Command and Macro 
Reference. 
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UPDATE 



Use the UPDATE command to modify program source 
files. The UPDATE command accepts a source input 
file and one or more files containing UPDATE control 
statements and updated source records; then it creates 
an updated source output file, an update log file 
indicating what changes, if any, were made, and an 
update record file if more than a single update file is 
applied to the input file. The format of the UPDATE 
command is: 



Update 



fn1 



ft1 
ASSEMBLE 



fml [fn2 [ft2 [fm2] ]]||[ (options. 



] 3I 



opt ions : 



fREP "I fSEC)8 "I pNC "I fCTL 1 
[NOREpJ L.NESEQ8J [noiNC] [ noCTLJ 

fSTK "I [TERM "I fDISK fSTOR 1 
[ _N0STKJ L N0TER MJ L PRINT L NQSTQR J 

[LINECOUN nn] 



OUTMODE fm 



The LINECOUN option controls the number of lines 
per print page which the UPDATE command produces. 
The default value is 55. Except for this option, the 
VM/PC UPDATE command is functionally equivalent 
to the VM/SP command. 

For a complete description of the UPDATE command, 
refer to the VM/SP CMS Command and Macro 
Reference. 
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XEDIT 



Use the XEDIT command to invoke the VM/PC editor 
to create, modify, and manipulate CMS disk files. 
Once the VM/PC editor has been invoked, you may 
execute XEDIT subcommands and use the System x 

Product Interpreter or EXEC 2 macro facility. 

You can return control to the CMS environment by 
issuing the XEDIT subcommand FILE, FFILE, QUIT, 
or QQUIT. 

For complete details on XEDIT subcommands and 
macros, see the publication VM/SP System Product 
Editor Command and Macro Reference. 

The format of the XEDIT command is: 
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Xedit 


[fn [ft [fm]]] [(options. ..[)]] 




opt ions : 


Width nn] 
^NOSCreen] 

PROFi le macroname] 
: N0PR0Fil] 
: N0CLear] 
: N0Msg] 




options valid only in update mode: 






UpdatelNOUpdate] 
: Seq8lNOSeq8] 
;Ctl fnllNOCtl] 

Merge] 

'UNti 1 f i letype] 
" 1 ncr nn] 
'SIDcode string] 



When XEDIT is first called, it is loaded into CMS free 
storage and installed as a nucleus extension. Further 
calls to XEDIT normally use this copy of XEDIT, thus 
eliminating the need to reload the XEDIT module. 

The VM/PC command XEDIT is functionally 
equivalent to the VM/SP command XEDIT, except 
that the default setting for the PF 1 key is the command 
'SPLTJOIN'. 

For a complete description of the XEDIT command, 
refer to the VM/SP CMS Command and Macro 
Reference. 
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Immediate Commands 



You can issue an Immediate command from the 
terminal only after causing an attention interruption by 
pressing the PA1 key, then entering the CP command 
ATTN or pressing the PA1 key a second time. These 
commands are processed as soon as they are entered. 

The HT and RT Immediate commands are also 
recognized when they are stacked in an EXEC 
procedure, and the HT Immediate command can be 
appended to a CMS command preceded by a logical 
line end symbol (#). Any program execution in 
progress is suspended until the Immediate command is 
processed. 

None of the Immediate commands issue responses. The 
Immediate commands are: 

• HI - Halt interpretation 

• HT - Halt typing 

• HX - Halt execution 

• RT - Resume typing 

• TE - Trace end 

• TS - Trace start 

HI: Use the HI (Halt Interpretation) command to 
cause all currently executing System Product Interpreter 
or EXEC 2 programs or macros to terminate execution 
without destroying the environment (as HX would). 
The format of the HI command is: 



HI 



HT: Use the HT command to suppress all terminal 
output generated by any CMS command or your 
program that is currently executing. The format of the 
HT command is: 
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HT 



Usage Notes: 

1. Program execution continues. When the ready 
message is displayed, normal terminal output 
resumes. Use the RT command to restore typing or 
displaying. 

2. CMS error messages having a suffix letter of S or T 
cannot be suppressed. 

HX: Use the HX command to stop the execution of 
any CMS command or program, close any open files or 
I/O devices, and return to the CMS command 
environment. The format of the HX command is: 



HX 



Usage Notes: 

1 . HX clears all file definitions made via the 
FILEDEF command, including those entered with 
the PERM option. 

2. The HX command is executed when the next SVC 
or I/O interruption occurs; therefore a delay may 
occur between keying HX and the return to CMS. 
All terminal output generated before HX is 
processed is displayed before the command is 
executed. 

3. HX does not clear user storage. 
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if J; Use the RT command to restore terminal output 
from an executing CMS command or one of your 
programs that was previously suppressed by the HT 
command. The format of the RT command is: 



RT 



Usage Note: Program execution continues, and 
displaying continues from the current point of 
execution in the program. Any terminal output that is 
generated after the HT command is issued and up to 
the time the RT command is issued is lost. Execution 
continues to normal program completion. 

TE: Use the TE (Trace End) command to stop all 
tracing of your System Product Interpreter or EXEC 2 
program or macro. The format of the TE command is: 



TE 



TS: Use the TS (Trace Start) command to start 
tracing of your System Product Interpreter or EXEC 2 
program or macro. The format of the TS command is: 



TS 
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Chapter 8. VM/PC Messages 



How To Use This Chapter 

This chapter lists messages alphabetically by the first 
word of the message. 

Note: Some messages begin with a replacement value, 
such as: 

userid NOT IN HOST DIRECTORY 

When the message is issued, 'userid' is replaced with an 
actual userid. Since we cannot tell what this userid will 
be, we cannot alphabetize the message. All messages 
that start with a replacement value are listed at the 
beginning of the Message Explanation section. 

Note: Initiation messages are not included in this 
section. Messages you might receive when starting 
VM/PC are explained in "What To Do if Something 
Goes Wrong" on page 4-36. 



Identifying Issuing Component 

This Chapter contains messages issued by the following 
components of VM/PC: 

• VM/PC CMS - These messages are listed here 
followed by the identifier (DMSxxxx). The xxxx is 
replaced by a number, like 00 IE, if the message has 
a number. 
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• VM/PC CP - These messages are listed here 
followed by the identifier (DMKxxxx). The xxxx is 
replaced by a number, like 00 IE. 

• CP Termination Messages - These messages are 
listed here followed by the identifier (DMKxxxT). 
The xxx is replaced by a number. 

• VMPCSERV (Host Services) - These messages are 
listed here followed by the identifier (SERV). 

Note: Not all possible VM/PC CMS Messages are 
explained here. We list all unique VM/PC messages 
and the most common CMS messages. See the VM/SP 
System Messages and Codes, order number ST00-1353, 
for explanations of all messages not listed here. 



Reading a Sample Message Explanation 

Here's a sample message: 

'cuu' replaces 'mode (cuu)' (DMS724 1 ) 

The message begins with a "Replacement Value" (cuu 
is replaced with a number like 101 when the message is 
issued) so it is not alphabetically listed. The information 
in parentheses that follows the message, (DMS724I), 
indicates that CMS issues the message and its number is 
7241. 

Following these, there is an explanation and an 
indication of how to recover, if necessary. 

Note: VM/PC displays all messages without numbers. 
If you want message numbers to be displayed with the 
the messages, issue the command: 

set emsg on 

See "SET" on page 7-50 for more information on this 
command. You would want to issue this command to 
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get message numbers displayed if you were having a 
problem and were seeking service help. 
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Message Explanations 



Messages are listed alphabetically by their first word, 
except for the first set of messages grouped under 
"Replacement Values." These messages begin with a 
value that changes based upon what you're doing or 
what your userid is, etc. 

If you receive a message that starts with your userid 
name, or a command name you just issued, or a device 
number, check the group of messages explained under 
the "Replacement Values" heading. 

REPLACEMENT VALUES 



'command' COMMAND NOT COMPLETED; HOST 
SERVICES NOT AVAILABLE (DMK049E) 

The command indicated could not be completed 
because you have not started the Host Services 
Program (VMPCSERV). 

'cuu mode' released (DMS726I) 

The specified disk has been released since you have 
asked that another disk be accessed for that mode. 

'cuu' already accessed as read/ write 'mode' disk 
(DMS059E) 

You are trying to access the specified disk in 
read-only mode, but you already have it accessed in 
read/ write mode. You cannot have the disk 
accessed as a read/write disk and as a read/only 
disk. Release the disk with the RELEASE 
command and reissue the ACCESS command. 
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'cuu' replaces 'mode (cuu)' (DMS724I) 

The disk being accessed replaces the disk specified 
in your search order. The disk it replaces is released. 

'cuu' also = 'mode'-disk (DMS725I) 

The disk being accessed is also accessed as the 
'mode' disk. 

'dvcadr' NOT DEFINED; SPACE NOT AVAILABLE 
(DMK091E) 

The temporary device has not been defined because 
sufficient blocks could not be found to allocate it. 

'mode (cuu)' read-only (DMS723I) 

The specified disk is accessed in read-only mode. 

'name' ENVIRONMENT DOES NOT EXIST 
(DMK044E) 

The control program cannot find the environment 
that you have entered. 

'name' ENVIRONMENT EXCEEDS STORAGE 
(DMK170E) 

The environment you entered is larger that your 
virtual machine storage size. Either enter another 
environment that will fit within that storage size or 
re-define your virtual machine storage size. 

'nnn' FB-512 blocks formatted on disk 'mode(cuu)' 
(DMS732I) 

This message tells you how many blocks have been 
formatted on the specified disk. 

'option' and 'option' are conflicting options 
(DMS066E) 

The specified options are mutually exclusive. 
Reissue the command specifying only one of the 
options. 

'option' option specified twice (DMS065E) 

The option was specified more than once in the 
command line. Reissue the command specifying the 
option only once. 
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'userid dvcadr' NOT LINKED; ALREADY DEFINED 
(DMK110E) 

The device you entered was not linked because your 
virtual machine configuration already has a device 
with the same address. 

'userid dvcadr' NOT LINKED; ALREADY LINKED 
(DMK105E) 

The device you entered was not linked because you 
already have a link to that device. 

'userid dvcadr' NOT LINKED; DOES NOT EXIST 
(DMK109E) 

The device you entered was not linked because the 
minidisk, although defined in the configuration file, 
has not been allocated. 

'userid dvcadr' NOT LINKED; NO PASSWORD 
(DMK113E) 

The device you entered was not linked because the 
device definition in the configuration file does not 
contain a password for the link mode you requested. 

'userid dvcadr' NOT LINKED; NOT IN 

CONFIGURATION FILE (DMK1 07E) 

The device you entered was not linked because it 

could not be found in the configuration file. 

'userid dvcadr' NOT LINKED; PASSWORD 
INCORRECT (DMK1 1 4E) 

The device you entered was not linked because the 
password you entered was incorrect for the link 
mode you requested. 

'userid dvcadr' NOT LINKED; HOST SERVICES NOT 
AVAILABLE (DMK075E) 

You entered a LINK command that was to be 
processed at the host but the Host Services Program 
was not active. 
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'userid dvcadr' NOT LINKED; SPACE NOT 
AVAILABLE (DMK1 1 9E) 

The device you requested write access to was not 
linked because it was not previously allocated and 
sufficient space was not available to perform the 
allocation. 

'userid dvcadr' NOT LINKED; VOLUME NOT 
MOUNTED (DMK108E) 

The device you entered was not linked because the 
diskette drive that it was defined on did not have a 
diskette in it or the drive does not exist. 

'userid' NOT IN HOST DIRECTORY (DMK053E) 

You entered a userid that could not be found in the 
VM directory at the host location. 

Special Characters 



?CP: command (DMK001E) 

You did not enter a valid CP command. 



B 



BLK MISSING OR INVALID (DMK024E) 

You did not enter the number of blocks or entered it 
incorrectly. It is incorrect if it is more than five 
characters or is not a decimal number. 



Cannot drop with 'NUCXDROP *'. Needed by 

active utility. (DMS727W) 

An attempt was made to drop a nucleus extension 
from within that particular nucleus extension. The 
nucleus extension is not dropped. 
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Cannot recompute without loss of data. No change 
(DMS214W) 

The number of blocks specified in the FORMAT 
command cannot contain all the data on the disk. 
Erase some files, or re-issue the FORMAT 
command with more blocks specified. 

CHARS MISSING OR INVALID (DMK245E) 

You did not enter the CHARS operand or it is 
longer than four characters. 

CLASS MISSING OR INVALID (DMK028E) 

You did not enter a class value or entered one that 
is not in the range A through Z or through 9. 



CMS subset (DMS) 

This is the CMS subset prompt. You enter subset 
mode by entering the SUBSET command, either 
explicitly, or implicitly by issuing the XEDIT 
subcommand CMS. To return to the environment 
you were in previously (either normal CMS 
command mode or the program from which you 
entered subset mode), issue the CMS subset 
command RETURN. 

Comparing <fn ft fm' with 'fn ft fm' (DMS179I) 

This is an informational message to tell you the 
fileids being compared. 

COMPLETION INTERRUPT FOR INACTIVE 
DEVICE (DMK005T) 

A Control Program I/O scheduling error has 
occurred. 

CONFLICTING OPTION - 'option' (DMK013E) 

You entered the same option twice in a command, 
or you entered an option that is incompatible with a 
previous one, or you entered an option that is 
incompatible with the system. 
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COPY MISSING OR INVALID (DMK030E) 

You did not enter the number of copies or entered it 
incorrectly. It is incorrect if it contains nondecimal 
digits or is greater than 99. 

CP ENTERED; DISABLED WAIT PSW 'psw' 
(DMK450W) 

The virtual machine loaded a disabled wait PSW, 
identified by 'psw'. You must re-IPL the 
environment. 

CP ENTERED; PAGING ERROR (DMK410W) 

An irrecoverable data error occurred on the virtual 
storage file. You must re-IPL the environment. 

CP ENTERED; PROGRAM INTERRUPT LOOP 
(DMK453W) 

A program interrupt occurred at the address 
specified in the virtual machine program new PSW. 

CP MESSAGE FILE NOT FOUND (DMK015T) 

The control program could not find the control 
program message file. Run the configurator and 
display the system configuration to find the filespec 
for the control program message file. 

CP NUCLEUS FILE NOT FOUND (DMK014W) 

The control program could not find the control 
program nucleus file. Run the configurator and 
display the system configuration to find the filespec 
for the control program nucleus. 

CP PROGRAM CHECK (DMK009T) 

A program check has occurred in the 370 portion of 
the control program. 

D 



DEV 'dvcadr' DOES NOT EXIST (DMK040E) 

You have entered a device address that is not part 
of your current virtual machine configuration. 
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DEV 'dvcadr' NOT DEFINED; ALREADY DEFINED 
(DMK092E) 

The device address you entered is already defined in 
your virtual machine's configuration. 

DEV 'dvcadr' NOT DEFINED; MAXIMUM NUMBER 
OF DEVICES DEFINED (DMK095E) 

The device you entered was not defined because 
you already have defined the maximum number of 
devices in your virtual machine configuration that 
the system will support. 

A virtual configuration can have one console, one 
printer, and 26 minidisks. 

DEV 'dvcadr' NOT DETACHED; CP OWNED 
(DMK123E) 

The device you entered is owned by the Control 
Program and cannot be detached. Your console and 
printer are owned by CP but are shared with your 
virtual machine. 

DEV 'dvcadr' NOT LINKED; MAXIMUM NUMBER 
OF DEVICES DEFINED (DMK117E) 

The device you entered was not linked because you 
already have defined the maximum number of 
devices in your virtual machine configuration that 
the system will support. 

A virtual configuration can have one console, one 
printer, and 26 minidisks. 

DEVICE TYPE MISSING OR INVALID 
(DMK035E) 

You did not enter a CP spool device type or entered 
it incorrectly. Valid device types are PRT and all 
abbreviations of PRINTER. 

Disk 'cuu' is read/only (DMS037E) 

The specified command requires a read/write disk. 
You should access the specified disk in read/write 
mode and reissue the original command. 
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Disk 'mode (cuu)' has invalid directory format 
(DMS112S) 

You have requested that a disk which is not in CMS 
format be accessed. The access has not been 
performed. Probably the disk has never been 
formatted. You must format the disk before you can 
access it. 

DISK 'mode<(cuu)>' IS FULL (DMS107S) 

There is not enough space on the specified disk to 
write the file. You may wish to erase some files 
from the disk, get a larger disk, or expand the size of 
the disk. 

Disk <'mode' | 'cuu'> not accessed (DMS069E) 

The specified disk has not been accessed. Reissue 
the command after accessing the specified disk. 

Disk 'mode (cuu)' is not available from the host server 
(DMS803E) 

The host server has been restarted, and no longer 
has a link for you to the requested disk. Link to the 
disk again and re-try the ACCESS. 

Disk is not local to VM/PC (DMS920E) 

The minidisk specified in the RESERVE command 
is not locally attached. There is no support for host 
minidisks within the RESERVE command. 

DISTCODE MISSING OR INVALID (DMK032E) 

You did not enter a distribution code or it was 
longer than eight characters. 

Drive 'd' not ready. Make drive ready and press enter 
(DMS807S) 

VM/PC has detected that the specified drive is not 
ready when I/O was to be done to the drive. Make 
the drive ready, and press the enter key to continue. 

DVCADR MISSING OR INVALID (DMK022E) 

You have not entered a device address or entered 
one incorrectly. It is incorrect if it is longer than 
three characters or contains nonhexadecimal data. 
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Enter disk label: (DMS605R) 

Format will write the specified label on the disk 
being formatted. You can enter a one to six 
character label for the disk. If you enter less than six 
characters, the label is left justified and padded with 
blanks. If you enter a null line, the system displays 
the message Disk remains unchanged. 

Erase * * <fm | *> not allowed (DMS071E) 

You cannot erase all files on a disk or all files on all 
disks. You can enter asterisks for the filename and 
file type, but you must specify the filemode letter 
and number. Correct and reissue the command. 

Error W reading file 'fn ft fm' from disk (DMS104S) 

An unrecoverable error occurred while reading the 
file from disk, "nn" indicates the nature of the 
error and may be one of the following: 

Code Meaning 

1 The specified file was not found. 

2 The buffer area is not within user 
storage limits. 

3 A permanent disk read error occurred. 
This may occur if you link to and access 
another user's disk, and try to read a file 
that was re-filed by its owner after you 
issued the ACCESS command. Reissue 
the command and try to read the file 
again. 

5 The number of records is less than zero 

or more than 32768. 

7 The fixed/variable flag in the file status 
table is not F or V. 

8 The given storage area was smaller than 
the actual size of the records read. (This 
error is valid if reading the first portion 
of a large record into a small buffer. It 
does not cause the function to 
terminate.) 
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9 The file is already active for writing and 

must be closed before it can be read. 

1 1 Only one record can be read for a 
variable-length file. In this case, the 
number of records is greater than 1 . 

12 An unexpected end of file occurred (the 
record number specified exceeds the 
number of records in the file). 

13 A variable-length file has an invalid 
displacement in the active file table. 

14 An invalid character has been detected 
in filename. 

15 An invalid character has been detected 
in file type. 

22 Virtual storage capacity has been 

exceeded. 

25 Insufficient virtual storage is available. 

26 Requested item number is negative, or 
item number plus number of items 
exceeds file system capacity. 

27 An attempt was made to update a 
variable length item with one of a 
different length. 

Error W writing file 'fn ft fm' on disk (DMS105S) 

An unrecoverable error occurred while writing the 
file on disk, "nn" indicates the nature of the error 
and may be one of the following: 

Code Meaning 

2 The virtual storage address is 0. 

4 The first character mode is invalid. 

5 The second character mode is invalid. 

6 The number of records in the file is too 
large; it cannot exceed 65,533. 

7 An attempt has been made to skip over 
an unwritten variable length item. 

8 The number of bytes was not specified. 

9 The file is already active for reading. 

10 The maximum number of CMS files has 
been reached. 

1 1 The fixed/variable flag is not F or V. 

12 The disk is not a CMS read/ write disk. 



Chapter 8. VM/PC Messages 8-13 



13 The disk is full (recoverable error). 

14 The number of bytes to be written is not 
integrally divisible by the number of 
records to be written. 

15 The length of this record is not the same 
as that of the previous record. 

16 The fixed/ variable flag is not the same 
as that of the previous record. 

17 A variable-length record is greater than 
65535 bytes. 

18 The number of records is greater than 1 
for variable-length file. 

19 The maximum number of data blocks 
per file (16060) has been reached. 

20 An invalid character has been detected 
in filename. 

21 An invalid character has been detected 
in filetype. 

22 Virtual storage capacity has been 
exceeded. 

25 Insufficient virtual storage is available. 

26 Requested item number is negative, or 
item number plus number of items 
exceeds file system capacity. 

27 An attempt was made to update a 
variable length item with one of a 
different length. 

Error 'nnnnn' when accessing minidisk 'xxx' as mode 4 y' 
(SERV) 

As the VMPCSERV program terminates and tries 
to restore the CMS environment which existed prior 
to your using the host server program, an error 
occurred as your CMS minidisks are being restored. 
The return code displayed is from the ACCESS 
command issued by VMPCSERV. 

Error 'nnnnn' when accessing minidisk *xxx' as mode V 
(SERV) 

As the VMPCSERV program terminates and tries 
to restore the CMS environment which existed prior 
to your using the host server program, an error 
occurred as your CMS minidisks are being restored. 
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Error in exec file 4 fn', line 4 nnn' - 'message' 
(DMS072E) 

The EXEC interpreter has found an error in the 
specified file, at line "nnn." Correct the EXEC file 
based on the text of the error message, and re-issue 
the command. 

Error in 'fn ft fm', line 'nnn' - 'message' (DMS085E) 
The EXEC2 interpreter has found an error in the 
specified file, at line "nnn." Correct the EXEC file 
based on the text of the error message, and re-issue 
the command. 

Error occurred when allocating a service (SERV) 

You should retry VMPCSERV and contact your 
technical co-ordinator if the program continues to 
fail. 

Error occurred when trying setup/remove I/O interrupt 
handler, return code: 'nnn' (SERV) 

You should retry VMPCSERV and contact your 
technical co-ordinator if the program continues to 
fail. 

Error occurred when trying to define a service (SERV) 

You should retry VMPCSERV and contact your 
technical co-ordinator if the program continues to 
fail. 

ERROR READING CP MESSAGE FILE 
(DMK016T) 

The control program had an irrecoverable data error 
while reading the control program message file. 
Restore the message file from VM/PC installation 
diskette 2. 

ERROR READING VM/PC CONFIGURATION FILE 
(DMK013T) 

The control program had an irrecoverable data error 
while reading the configuration file. Run the 
configurator to correct any data problems. 
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Error when trying to display the logo (SERV) 

You should retry VMPCSERV and contact your 
technical co-ordinator if the program continues to 
fail. 

Execution begins... (DMS740I) 

You have requested the execution of a program 
under CMS. 

Export terminated, insufficient disk space available 
(DMS806E) 

The EXPORT of the file failed because there was 
no space left on the drive to create the PC file. You 
should make enough space available on the drive to 
create the file, and retry the operation. 



FATAL ERROR FROM HOST SERVICES 
(DMK020T) 

The control program had an irrecoverable error 
while performing host services. 

FCB MISSING OR INVALID (DMK246E) 

You did not enter the FCB operand or it is longer 
than four characters. 

File 'fn ft fm' already exists — specify 'replace' 
(DMS024E) 

The specified file already exists. Reissue the 
command with the REPLACE option if you wish to 
overlay the existing copy of the file. 

File 'fn ft fm' is not fixed length (DMS034E) 

The specified command will only work on fixed 
format files. You can change the record format of 
the file using the COPYFILE command with the 
RECFM F option, and re-issue the original 
command. 
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File <fn ft fm' not found (DMS002W) 

The specified file was not found on the accessed 
disk(s). Either the file does not exist on this disk, or 
the fileid was misspelled. 

File(s) 'fn ft fm' not found. Disk 'mode(cuu)' will not be 
accessed (DMS060E) 

The files requested were not on the specified disk 
or, if the disk contains no files and you accessed it 
as an extension, your access fails. Check to see that 
the fileid specified is valid and reissue the command. 

File cannot be exported with the 6 EOL' option 
(DMS808S) 

The file to be exported has a logical record length 
greater than 65535, and cannot be exported with 
the 'EOL' option. Either use the NOEOL option of 
EXPORT, or use the CMS COPYFILE command 
to change the logical record length of the CMS file 
prior to retrying the EXPORT. 

Files do not compare (DMS209W) 

The two files you requested to be compared did not 
match on a line for line, column for column basis. 

FLASH MISSING OR INVALID (DMK243E) 

You did not enter the FLASH operand or you 
entered it incorrectly. It is incorrect if it contains 
nondecimal digits or is larger than 255. 

FNAME FTYPE MISSING OR INVALID 
(DMK029E) 

You did not enter a filename or filename and 
filetype, or you entered it incorrectly. It is incorrect 
if the filename is larger than 24 characters, or if the 
filetype is larger than eight characters when the 
filename is eight characters or less. 

FORM NUMBER MISSING OR INVALID 
(DMK024E) 

You did not enter a form number after the FORM 
keyword or entered one longer than eight 
characters. 
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Format will erase all files on disk 'mode(cuu)\ Do you 
wish to continue? (yes | no): (DMS603R) 

You have requested a FORMAT of the cuu disk. 
This prompt allows you to change your mind, in 
case you have made a typing error, or decided that 
the FORMAT should not be done at this time. You 
should reply yes if you wish the format to continue 
or the FORMAT will stop without changing the 
disk. 

Formatting disk 'mode' (DMS733I) 

The FORMAT command is formatting the specified 
disk. 



H 



HEXLOC 'hexloc' EXCEEDS STORAGE 
(DMK160E) 

The hexadecimal location you entered exceeds your 
virtual machine storage size. 

Host disk 'mode (cuu)' released (DMS802E) 

The communication with the host server has been 
stopped or restarted. The host minidisks which you 
had accessed are released automatically. To 
re-establish the connection to host minidisks you 
should restart the host server if it is not running, and 
issue the appropriate LINK and ACCESS 
commands to establish the connection to the host 
minidisks again. 



I/O ERROR OCCURRED ON IPL (DMK232E) 

An irrecoverable data read error occurred during the 
IPL of the environment you entered. 

I/O REQUESTED AND DEVICE RETURNED BUSY 
STATUS (DMK004T) 

A CP I/O scheduling error has occurred. 
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I/O REQUESTED AND RDEVBLOK IS FLAGGED 
AS BUSY (DMK003T) 

A CP I/O scheduling error has occurred. 

Identical f ileids (DMS01 9E) 

The fileids specified are identical. Reissue the 
command and specify two different fileids. 

IMPORT terminated, file 'd:filename.ext' truncated 
(DMS805E) 

The IMPORT command did not work correctly. 
Check if the file you're importing is too large. 

Insufficient storage to start communications (SERV) 
The VMPCSERV program acquires buffers 
dynamically to use in communications with the local 
session. You should increase your host virtual 
machine size and restart VMPCSERV. 

Invalid character 'character' in f ileid 4 f n ft f m' 
(DMS062E) 

The fileid specified was not valid. Check to see that 
the fileid specified is valid and reissue the command. 

Invalid CMS command (DMS) 

The command you entered is not valid. 

INVALID DEVICE TYPE - 'dvcadr' (DMK006E) 

The device type of the indicated device is incorrect 
for the function you requested. 

Invalid export of a CMS file to a system file 
(DMS800E) 

You have requested an EXPORT of a CMS file 
directly to a file used by the VM/PC system. 
EXPORT will not allow this, and the EXPORT is 
not performed. If you wish to do this, you must 
EXPORT the file to a temporary PC file, exit 
VM/PC and rename the exported file to the system 
fileid which you want. 
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Invalid filetype 'ft' (DMS032E) 

The filetype entered was not valid for the command. 
Reissue the command with a valid filetype specified. 

INVALID HEXDATA - 'hexdata' (DMK005E) 

The hexadecimal data you entered either contained 
nonhexadecimal characters or was longer than eight 
characters. 

INVALID HEXLOC - 'operand' (DMK004E) 

The hexadecimal location you entered either 
contained nonhexadecimal characters or was longer 
than six characters. 

Invalid mode 'mode' (DMS048E) 

The mode which has been specified on the 
command is invalid. This may be due to misspelling 
or improper command format. Reissue the 
command with a correct filemode. 

Invalid mode change (DMS05 1 E) 

The filemode letter specified for the old fileid is not 
the same as that specified for the new fileid. 
Reissue the command with the correct filemodes. 

INVALID OPERAND - 'operand' (DMK002E) 

One of the command operands you entered was not 
correct. 

INVALID OPTION - 'option' (DMK003E) 

One of the options you entered was not correct or 
should not be used with the command variation you 
used. You might have given too short an 
abbreviation for the option. 

Invalid option 'option' (DMS003E) 

The specified option is invalid. It may have been 
misspelled or an improper abbreviation for the 
option may have been specified. 
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Invalid parameter 'parameter' (DMS070E) 

An invalid operand was specified in the command 
line. Correct and reissue the command. 

Invalid parameter 'parameter' for 'function' function 
(DMS026E) 

The data specified for the given function is 
misspelled, missing or invalid. Reissue the command 
with valid data for the function. 

Invalid parameter 'parameter' in the option 'option' field 
(DMS029E) 

The data entered following the specified option was 
invalid. Reissue the command with valid data after 
the option. 

Invalid PC fileid 'd:filename.ext' specified (DMS804E) 

The PC fileid specified is invalid. Retry the 
command with a valid fileid. 

INVALID PSW - 'psw' (DMK012E) 

The PSW (program status word) you entered in the 
STORE command has the extended control mode 
bit on. 

INVALID RANGE - 'range' (DMK009E) 

The range of addresses or registers you entered is 
incorrect. For instance, the end address may be 
smaller than the starting address. 

INVALID REGISTER - 'register' (DMK010E) 

The register you entered was not in the range 
through 15 or hexadecimal through F, or was not 
0, 2, 4, or 6 for a floating-point register. 

INVALID SPOOLID - 'spoolid' (DMK008E) 

The spoolid you entered was not a decimal number 
or was longer than four characters. 

Invalid subset command (DMS) 

The command you entered cannot be executed from 
CMS subset mode due to restrictions in where the 
command must execute. Commands which execute 
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in the user area are not permitted to be executed 
from CMS subset mode. 

Invalid subsystem was specified on ALLOCATE 
(SERV) 

You should retry VMPCSERV and contact your 
technical co-ordinator if the program continues to 
fail. 

Invalid subsystem was specified on DEALLOCATE 
(SERV) 

You should retry VMPCSERV and contact your 
technical co-ordinator if the program continues to 
fail. 

IRRECOVERABLE MACHINE CHECK 
(DMK008T) 

The 370 processor has encountered an error for 
which there is no recovery. 



Line I/O error 'nnnnn' during read operation. Sense data 
is 'xx\ (SERV) 

You should retry VMPCSERV and contact your 
technical co-ordinator if the program continues to 
fail. 

Line I/O error 'nnnnn' during write operation. Sense 
data is 'xx\ (SERV) 

You should retry VMPCSERV and contact your 
technical co-ordinator if the program continues to 
fail. 

LINECT MISSING OR INVALID (DMK034E) 

You did not enter the number of lines per page or 
you entered it incorrectly. It is incorrect if it 
contains nondecimal digits or is greater than 255. 
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M 



MODIFY MISSING OR INVALID (DMK253E) 

You did not enter the MODIFY operand or it is 
longer than four characters. 



N 



No 'option' specified (DMS005E) 

The specified option was entered in an incomplete 
form. 

NO CFRB AVAILABLE (DMK01 IT) 

An error has occurred in the management of console 
function requests. 

No device specified (DMS028E) 

The command requires that you specify a device 
address. Reissue the command with a valid device 
address. 

No fileid<(s)> specified (DMS042E) 

At least one fileid must be specified for the 
command issued. Reissue the command, specifying 
at least one fileid. 

No filemode specified (DMS223E) 

A filemode was not specified in the command line. 
Reissue the command specifying a filemode. 

No filename specified (DMSOO 1 E) 

The command you entered requires that you specify 
at least one filename. Reissue the command and 
specify the filename(s). 

No files loaded (DMS040E) 

You have not previously issued a LOADMOD or 
LOAD command to load an executable module. 
You should load the required files, and then reissue 
the original command. 
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No filetype specified (DMS023E) 

The command you entered requires that you specify 
both filename and filetype. Reissue the command 
and specify the filename and filetype. 

NO IOB AVAILABLE (DMK006T) 

A Control Program I/O scheduling error has (, 

occurred. 

NO PAGE FRAMES AVAILABLE (DMK01 8T) 

A virtual storage management error has occurred. 

NO SAVE AREA AVAILABLE (DMK001T) 

A Control Program subroutine call has been issued 
and no internal save area is available. 

No user-defined FILEDEFs in effect (DMS324I) 

No current FILEDEFs exist. Reissue the command 
specifying a filemode. 

NO USER DEFINITIONS IN CONFIGURATION 
FILE; RUN CONFIGURATOR (DMK017T) 

The control program found no user information in 
the configuration file. Run the configurator to 
define the user(s) of the system. 

O 



OPERAND MISSING OR INVALID (DMK026E) 

You did not enter a required operand or entered it 
incorrectly. 

OS simulation is not available (DMS098S) 

An OS SVC was issued, and the CMS OS 
simulation support was not available at that time. 
Issue the command SET OSSIM ON, and re-issue 
the command. 
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PAGING I/O ERROR ON CP NUCLEUS 
(DMK019T) 

The control program had an irrecoverable data error 
while reading the control program nucleus file. 
Restore the nucleus file from VM/PC installation 
diskette 2. 



R 



Ready; (DMS) 

This is the CMS prompt, and tells you that CMS is 
waiting for a command. It may also appear as 
Ready (re); where re is the return code of the 
previous command you entered. 



Server ended due to severe I/O errors (SERV) 

You should retry VMPCSERV and contact your 
technical co-ordinator if the program continues to 
fail. 

SPOOL ERROR; FILE CLOSED WITH HOLD 
OPTION (DMK428E) 

An error occurred while writing spool information 
onto disk. A spool file is created, if possible, with 
any existing spool data, and that file is placed in 
HOLD status. 

SPOOL ERROR; VOLUME NOT MOUNTED 
(DMK430E) 

You do not have a diskette in the drive to which 
spool files have been directed. 

SPOOL SPACE FULL; FILE CLOSED WITH HOLD 
OPTION (DMK427E) 

The disk or disk directory is full, or the maximum 
number of spool files have already been used. A 
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spool file is created, if possible, with any existing 
spool data, and that file is placed in HOLD status. 

SPOOLID 'nnnn' DOES NOT EXIST (DMK042E) 

You have entered a spoolid that does not exist or is 
currently being processed. 

SPOOLID MISSING OR INVALID (DMK027E) 

You did not enter a spoolid or entered it incorrectly. 
It is incorrect if it is longer than four characters or 
contains nondecimal digits. 

STORAGE EXCEEDS ALLOWED MAXIMUM 
(DMK094E) 

The storage size you entered exceeds the system 
allowed maximum of 4 megabytes. 

STORAGE MISSING OR INVALID (DMK025E) 

You did not enter the amount of storage or entered 
it incorrectly. It is incorrect if it contains 
nondecimal digits or does not end with the letter K 
or M. 

STORE REGISTER EXCEEDS MAXIMUM VALUE 
(DMK163E) 

You entered more data to be consecutively stored in 
either general or floating-point registers than there 
are registers for that data. 



TERMINAL ASYNCHRONOUS INTERRUPT WAS 
NOT ATTENTION (DMK002T) 

An asynchronous interrupt from the simulated 3277 
for the Local Session was presented and the status 
associated with that interrupt was not attention. 

The following names are undefined: (DMS201W) 

A list of names of unresolved external references is 
displayed. You may obtain access to the specified 
files by issuing the appropriate INCLUDE 
command, or ignore the warning message if the 
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modules are not needed for correct execution of 
your program. 

The host server has been restarted. Connection to host 
disks has been lost. (DMS809E) 
VM/PC detected that the host server has been 
stopped and restarted. You must re-establish the 
connection to host minidisks by issuing the 
appropriate LINK and ACCESS commands for 
those minidisks. 

The host server is not available. Connection to host disks 
has been lost. (DMS801E) 

The communication with the host server program 
has been stopped. You must re-start the host 
VMPCSERV program to re-establish 
communications with the host server, and issue the 
appropriate LINK and ACCESS commands to 
establish your host minidisks. 

The 'xx' disk does not exist. Disk 4 yyy' accessed as mode 
<z\ (SERV) 

As the VMPCSERV program terminates and tries 
to restore the CMS environment which existed prior 
to your using the host server program, an error 
occurred as your CMS minidisks are being restored. 
The disk to be accessed was originally accessed as 
an extension of another disk. The extension mode 
disk was not accessed when the VMPCSERV 
program was invoked, and therefore, the original 
environment cannot be recreated for you. 

TRACE NOT STARTED (DMK1 80W) 

You entered the TRACE END command and trace 
was not in effect. 
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u 



Unknown CP/CMS command (DMS) 

The command you entered is not a valid CP or CMS 
command. You might have typed the command 
incorrectly or have given too short an abbreviation 
for the command. 

USERID MISSING OR INVALID (DMK020E) 

You have either failed to enter a userid in a 
command or entered an invalid userid, such as one 
longer that eight characters. 

V 



Virtual storage capacity exceeded (DMS109S) 

There is not enough storage in your virtual machine 
to successfully complete execution of the command. 
You may wish to define a larger virtual storage, 
restart CMS and reexecute the command. 

VIRTUAL STORAGE TRANSLATION EXCEPTION 
(DMK010T) 

A virtual storage management error has occurred. 

VM/PC CONFIGURATION FILE NOT FOUND 
(DMK012T) 

The control program could not find the 
configuration file. The configuration file filespec is 
CONFIG. 1VM and may reside on either fixed disk 
CorD. 
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You must have at least 26 device addresses available 
between 201 and 5FF to start the host server. 
(SERV) 

The VMPCSERV program may need up to 26 
different virtual devices available in order to link to 
host minidisks for you. As the program starts, it 
checks to see if it will have enough available, and 
terminates if this condition is not satisfied. You 
should make at least 26 virtual addresses between 
201 and 5FF available before restarting 
VMPCSERV. 
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Appendix A. CP/CMS Interface 



Privileged Operation Simulation 

The following privileged operations are supported: 

Set Storage Key - SSK 

Insert Storage Key - ISK 

Set System Mask - SSM 

Load PSW - LPSW 

Test I/O - TIO 

Store CPU ID - STIDP 

Set Clock - SCK 

Set PSW Key from Address - SPKA 

Insert PSW Key - IPK 

Set CPU Timer - SPT 

Store CPU Timer - STPT 

Privileged operations not listed above are not supported 
and, if executed, will cause an operation program check 
to be reflected to the Virtual Machine. Operations 
listed above but not described below, function as 
described in the System/370 Principles of Operations. 

For privileged operations which modify the PSW, only 
the BC format of the PSW is supported. 

Set Storage Key - SSK 

The hardware does not support storage protection, but 
storage keys can be set and may be retrieved by the ISK 
instruction. The Fetch Protect and Dynamic Address 
Translation bits (4-6) are ignored. 
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Insert Storage Key - ISK 

The requested storage key is returned as set by the SSK 
instruction, but the Fetch Protect and Dynamic Address 
Translation bits (4-6) will always be zero. 

The storage key bits in the PSW, 8-11, (for LPSW and 
interrupt PSW swaps) will be maintained although no 
storage protection is performed. 

Test I/O - TIO 

The TIO instruction may be used to clear pending I/O 
interrupts. However, since most of the I/O operations 
are performed synchronously (without I/O interrupts) 
via the Diagnose Interface, most of the time this 
instruction is executed it will return condition code 
(I/O device available) or 3 (I/O device not available). 

The only virtual machine I/O interrupts that are 
presented are for asynchronous terminal attentions and 
completion interrupts for Diagnose 58. 

Set Clock - SCK 

The TOD Clock is managed by the PC DOS and is 
always secure. As a result the SCK instruction always 
returns condition code 1 . 



H 



A-2 VM/PC User's Guide 



Diagnose Instruction in VM/PC 

The DIAGNOSE instruction cannot be used in a virtual 
machine for its normal function. If a virtual machine 
attempts to execute a DIAGNOSE instruction, a 
program interrupt returns control to CP. Since a 
DIAGNOSE instruction issued in a virtual machine 
results only in returning control to CP and not in 
performing normal DIAGNOSE functions, the 
instruction is used for communication between a virtual 
machine and CP. 

The machine language format of DIAGNOSE is: 

< 4 bytes > 



83 


Rx 


Ry 


CODE 



Where: 

83 

is X'83' and interpreted by the assembler as the 
DIAGNOSE instruction. 

Note: There is no assembler mnemonic for 
DIAGNOSE. 

Rx,Ry 

are general purpose registers that contain operand 
storage addresses or return codes passed to the 
DIAGNOSE interface. 

CODE 

is a two-byte hexadecimal value that CP uses to 
determine what DIAGNOSE function to perform. 
The codes defined for the VM/PC user are 
described in this section. 
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Because DIAGNOSE operates differently in a virtual 
machine than it does in a real machine, a program 
should determine that it is operating in a virtual 
machine before issuing a DIAGNOSE instruction, and 
prevent execution of a DIAGNOSE when in a real 
machine. The Store Processor ID (STIDP) instruction 
provides a program with information about the 
processor in which it is executing, including the 
processor version number. If STIDP is issued from a 
virtual machine, the version number will be X'FF' in 
the first byte of the CPUID field. 

A virtual machine issuing a diagnose instruction should 
run with interrupts disabled. This prevents loss of 
status information pertaining to the diagnose operation 
such as condition codes and sense data. 

Note: A DIAGNOSE instruction with invalid 
parameters may in some cases result in a specification 
exception. 
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DIAGNOSE Code X'OO' — Store 
Extended-Identification Code 



Execution of DIAGNOSE code X'OO' allows a virtual 
machine to examine the VM/PC 
extended-identification code. 

The register specified as Rx contains the double-word 
aligned virtual storage address where the VM/PC 
extended-identification code is to be stored. The Ry 
register contains the number of bytes to be stored 
entered as an unsigned binary number (maximum of 32 
bytes). 

The following data is returned to the virtual machine 
(at the location specified by Rx): 



Field 

System 
Name 
Version 
Number 



Version 
Code 



Description 

"VM/PC" 

The first byte is the version 
number, the second byte is the 
level, and the third byte is the 
Service Level number. 
VM/PC CP executes the STIDP 
(Store Processor ID) instruction to 
determine the version code. 



Characteristics 

8 bytes, 
EBCDIC 

3 bytes, 
hexadecimal 



1 byte, 
hexadecimal 
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Field 


Description 


Characteristics 


MCEL 


VM/PC CP executes the STIDP 


2 bytes, 




instruction to determine the 


hexadecimal 




maximum length of the MCEL 






(Machine Check Extended 






Logout) area. 


Processor 


Always zero 


2 bytes, 


Address 




hexadecimal 


Userid 


The userid of the virtual machine 


8 bytes, 




issuing the DIAGNOSE. 


EBCDIC 


Program 


Identifies the program products 


8 bytes, 


Product Bit 


that are installed. Valid values 


hexadecimal 


Map 


and the program products each 





identifies are: 

Value Program Product 

X'0 100000000000000' VM/PC 

Upon return, Ry contains its original value less the 
number of bytes that were stored. 

No completion code is returned, and the condition code 
remains unchanged. 
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DIAGNOSE Code X<08' — Virtual 
Console Function 



DIAGNOSE Code X'08' enables a virtual machine 
running in supervisor state to issue CP commands. The 
virtual machine must specify the command, the 
command parameters, and whether CP is to return the 
command response to the user's terminal or to a buffer. 
In addition to returning the command response, CP sets 
a completion code in the Ry register and may set a 
condition code. 

When DIAGNOSE Code X'08' is issued, the Rx and 
Ry registers must be set up as follows: 

Rx 

Rx must point to the character string in virtual 
storage that contains the CP commands and 
parameters. If the character string contains multiple 
commands, each command and its associated 
parameters must be separated from adjacent 
commands by the value X'15\ 

Ry 

The high-order byte contains flag bits; the other 
three bytes specify, in bytes, the length of the CP 
commands and parameters. The maximum 
allowable length is 240 characters. 

Set the flag bits as follows. If CP is to return the 
command response in a buffer, set the second flag bit to 
a value of one (X<40'). 

If the Ry register contains the value X'00000000', the 
DIAGNOSE Code acts as a -no-operation (NOP) 
instruction. As a consequence, the issuing virtual 
machine is placed into a "CP-READ" state. 
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If the command response is to be returned in a buffer, 
Rx and Ry cannot be consecutive registers nor can 
either be register 15. In addition, the Rx+ 1 and Ry+ 1 
registers must be setup as follows: 

Rx+1 

Rx+1 must point to the buffer in virtual storage 
where CP is to return the command response. 

Ry+1 

Ry+1 must specify, in bytes, the length of the 
buffer. This value must not exceed 8192. 

If the command response is to be returned in a buffer, 
CP sets a condition code and returns information as 
follows: 

condition code 

The request was successful. The Rx+1 register 
points to the buffer that contains the command 
response. The Ry+ 1 register specifies the length of 
the response. 

condition code 1 

The request was unsuccessful. The response does 
not fit into the buffer. The Ry+1 register contains 
a value that specifies how many bytes of the 
response would not fit into the buffer. 

When CP returns to a program executing a 
DIAGNOSE 8 instruction, the length value that was 
supplied in register Ry is replaced by the CP completion 
code value. This value is zero if the CP console 
function was successfully executed. If an error 
occurred, the completion code is the numeric value 
expressed in the message describing the error. For 
example, if error message DMKCFM045E is issued, CP 
sets a completion code of 45. 

If the user has not specified a command response 
buffer, error messages and informational messages are 
generated according to the current values established by 
SET EMSG and SET IMSG commands. 
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If a command response buffer is used, error and 
informational messages are always put into the buffer 
instead of being written to the console. Each line of the 
response is followed by a new line character (X'15'). If 
the buffer is not long enough to contain all of the 
response lines, only as many complete lines as can fit 
into the buffer are supplied, so the last character 
written into the response buffer by CP is always a new 
line character. Any unused portion of the response 
buffer is not changed. The setting of IMSG is ignored 
(it is considered always to be ON) and the setting of 
EMSG determines only whether the error message code 
is retained. (SET EMSG OFF is treated the same as 
SET EMSG ON; SET EMSG TEXT suppresses error 
message codes.) 

The completion code values returned by CP are not 
affected by the values of EMSG and IMSG, or by the 
use of a command response buffer. 

If CP is executing multiple commands and encounters 
an invalid command, processing stops and CP ignores 
the remaining commands. 

Following are two examples showing how to specify 
DIAGNOSE Code X'08\ The first example shows 
how a program issues the QUERY SET command. In 
this example the response is returned to the user's 
terminal. 

LA 6,CMMD 

LA 10,CMMDL 

DC X , 83',X , 6A , 9 XL2 , 0008' 



CMMD DC C QUERY SET 1 

CMMDL EQU *-CMMD 
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The second example shows how to specify a string of 
commands when multiple commands are to be issued. 

LA 6,CMMD 

LA 10,CMMDL 

DC X'83',X'6A\XL2'0008' 



CMMD DC C QUERY SET' 

DC X'15' 

DC C'SET RUN OFF 1 

CMMDL EQU *-CMMD 
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DIAGNOSE Code X'OC — Pseudo 
Timer 



Execution of DIAGNOSE Code X'OC causes CP to 
store four double-words of time information in the 
user's virtual storage. The register specified as Rx 
contains the address of the 32 byte area where the time 
information is to be stored. The address must be on a 
double-word boundary. 

The first eight bytes contain the 
Month/Day-of -Month/Year. The next eight bytes 
contain the time of day in Hours/Minutes/Seconds. 
The last 1 6 bytes contain the virtual and real processor 
time used and each is simulated with the elapsed time 
(in micro-seconds) since the virtual machine was logged 
on. No completion code is returned, and the condition 
code remains unchanged. 
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DIAGNOSE Code X'10' — Release 
Pages 



Pages of virtual storage can be released by issuing a 
DIAGNOSE Code X'10\ When a page is released, it is 
considered all zero. The register specified by Rx 
contains the address of the first page to be released, 
and the Ry register contains the address of the last page 
to be released. Both addresses must be on page 
boundaries. A page boundary is a storage address 
whose low order three digits, expressed in hexadecimal, 
are zero. No completion code is returned, and the 
condition code remains unchanged. 

Do not use DIAGNOSE Code X'10' to release 
noncontiguous virtual storage. 
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DIAGNOSE Code X<18' — Standard 
DASD I/O 



Input/Output operations to FBA type DASD minidisks, 
of the type used by CMS, can be performed from a 
virtual machine using Diagnose 018. No interrupts are 
returned to the virtual machine; the instruction 
completes only when the read or write operation has 
completed. Rx contains the address of the minidisk; Ry 
points to the following chain of CCWs: 

DEFINE EXTENT, extent, CC, 16 

LOCATE BL0CK,blockid,CC,8 

READ or WRITE BLOCK , data ,0 ,n 5C 512 

or 

DEV CHAR, data, 0,32 

Where: 

extent 

defines the extent of the minidisk: 

DS X MASK X|00|=allow write 

X ' 01 l = i nh i b i t wr i te 
RESERVED 
BLKSIZE=512 

DEVICE OFFSET TO FIRST BLOCK 
FIRST BLOCK IN MINIDISK 
LAST BLOCK IN MINIDISK 

blockid 

defines the block(s) to read or write: 

DS X SUB-COMMAND X ' 01 '=write 

X'05'=wr ite/check 
X'06'=read 

DC X'00' RESERVED 

DS H NUMBER OF BLOCKS 

DS F BLOCK OFFSET WITHIN MINIDISK 



DC 


X'00 1 


DC 


X'OOOO' 


DC 


F'O' 


DC 


F'O' 


DS 


F 
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data 

the storage address of the data area to read into 
or write from. For improved performance, this 
data area should not cross a page boundary. 

NOP (X'03') and TIC (X'08') CCW codes are also 
supported anywhere within the chain. 

The condition and completion code are as follows: 

cc=o 

I/O complete with no errors 

CC=1 

Device availability error, reg 1 5 contains completion 
code: 

R15 = 1 - Device not in virtual machine 

configuration 
R15=2 - Device not available (for example, 

disabled or powered off), or device not 

locally supported. 
R15=3 - Attempt to write to read/ only device. 
R15 = 5 - Device busy 

CC=2 

CCW or control data error, reg 15 contains 
completion code: 

R15 = l - extent error 

R15=2 - operation error (operation byte in blockid 

doesn't match the READ or WRITE 

CCW) 
R15=3 - invalid CCW chain format 
R15=5 - CCW string not on double-word boundary 

CC=3 

Unrecoverable I/O error, reg 15 contains 
completion code: 

R15=3 - CCW count not multiple of 512 

R15=4-End-of-File 

R15=5 - Media I/O error 
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DIAGNOSE Code X'20' — General I/O 

Input/Output operations to the terminal and printer 
devices can be performed from a virtual machine using 
Diagnose 020. No interrupts are returned to the virtual 
machine; the instruction completes only when the read 
or write operation has completed. Rx contains the 
virtual device address; Ry points to the following 
CCWs: 

Dasd: Same as Diagnose 18, except that the data 
transfer length need not be a multiple of 512 bytes. 

Terminal control: X'03 \data,0,control, 1 

Terminal write: X'09\data,0,len 

Terminal read: X'0A\data,0,len 

Printer write - Local printer: 

X'03',data,CC 5 l NOP 

X'08\data,CC 5 l TIC 

X'01 ' ,data,CC,len Print, no space 

X'09' ,data,CC,len Print, space 1 

X ' 11 * ,data,CC,len Print, space 2 

X 1 19' ,data,CC,len Print, space 3 

X'89' ,data,CC,len Print, skip to top of page 

X'OB' ,data,CC,l Space 1 

X* 13' ,data,CC,l Space 2 

X'lB' ,data,CC,l Space 3 

X'8B' ,data,CC,l Skip to top of page 

Printer write - Remote Spool: Any valid CCW chain 
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Where: 

len 

is the length of the data area. For the terminal input 
and local printer output, the maximum length is 132. 

control 

control flags 

X'80' 

quiet mode command control - used to replace 
RUNNING display status with WAITING. 

data 

is the storage address of the data area to read into 
or write from. 

The condition and completion code are as follows: 

CC=0 

I/O complete with no errors 

CC=1 

Device availability error, reg 15 contains completion 
code: 

R15 = 1 - Device not in virtual machine 

configuration 
R15=2 - Device not available (for example, 

disabled or powered off), or device not 

locally supported. 
R15=3 - DASD: attempt to write to read/only disk. 
R15 = 5 - Device busy 

CC=2 

CCW error, reg 15 contains completion code: 

R15 = l - DASD: extent error. 

R15=2 - DASD: operation error (operation byte in 

blockid doesn't match the READ or 

WRITE CCW) 
R15=3 -invalid CCW 
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R15=5 - CCW string not on double-word boundary 

CC=3 

Unrecoverable I/O error, reg 15 contains 
completion code: 

R15 = l - Print: Host Services not available 

R15=2 - Print: Spool space full 

R15 = 3 - Print: Spool volume not mounted 

R15=4-Dasd: End-of-File 

R15 = 5 - Dasd: Media I/O Error 

R15 = 53- Print: Spool I/O Error 
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DIAGNOSE Code X'24' — Device Type 
and Features 



DIAGNOSE Code X'24' requests CP to provide the 
virtual machine with identifying information and status 
information about a specified virtual machine device. 
The virtual machine must specify the device address for 
which the information is requested. CP returns 
information about that device in the Rx, Ry, and Ry+ 1 
registers. CP also provides a condition code identifying 
the specific device information returned to the virtual 
machine. 

When a virtual machine issues DIAGNOSE Code 
X'24', the Rx register must contain the virtual device 
address for which information is requested or the values 
negative 1 or 2 (-1 or -2). Specify -1 when the device 
is the keyboard/display whose address is unknown to 
the virtual machine. Specify -2 when the device is the 
virtual machine printer whose address is unknown. 

When CP returns control to the virtual machine, the 
Ry, Ry+1, and Rx registers contain device information. 
The Ry and Ry+1 register contain information about 
the device. If -1 was specified, the Rx register contains 
the address of the keyboard/display. If -2 was 
specified, the Rx register contains the address of the 
virtual machine printer. 

The following diagrams identify specific information 
returned by CP and show how to locate this 
information in the Rx, Ry, and Ry+ 1 registers. The 
symbolic names used in these diagrams are the symbolic 
names used with VDEVBLOK, and RDEVBLOK in 
VM/SP Data Areas and Control Block Logic. 
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Rx Register: 



Byte 


Byte 1 


Byte 2 Byte 3 






vi rtual 
devi ce 
address 



R y Register: 



Byte 


Byte 1 


Byte 2 


Byte 3 


VDEVTYPC 


VDEVTYPE 


VDEVSTAT 


VDEVFLAG 



Symbolic Name Meaning: 

VDEVTYPC Virtual device type class 

VDEVTYPE Virtual device type 

VDEVSTAT Virtual device status 

VDEVFLAG Virtual device flags 

Ry+1 Register: 



Byte 


Byte 1 


Byte 2 


Byte 3 


RDEVTYPC 


RDEVTYPE 


RDEVMDL 


RDEVFTR 
- or - 
REDVLLEN 



Symbolic Name 

RDEVTYPC 

RDEVTYPE 

RDEVMDL 

RDEVFTR 

RDEVLLEN 



Meaning 

Real device type class 

Real device type 

Real device model number. 

Real device feature code for a 
device other than the 
keyboard/display. 

Current device line length for 
the keyboard/display. 
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The following chart lists the condition codes CP can 
return for DIAGNOSE Code X'24', the meaning of 
each condition code, and the registers where data is 
returned. 



If the condition 
code equals 


This register 
contains information 


Comments 


Rx 1 


Ry 


Ry + 1 2 





X 


X 


X 


Normal completion 


3 








Invalid device address or the virtual 
device does not exist 


1 The Rx register contains information only when DIAGNOSE Code X'24' 
specifies a keyboard/display or virtual machine printer whose address is 
unknown. 

2 If Ry is register 15, CP returns only virtual device information: no information 
is returned in register Ry + 1. 
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DIAGNOSE Code X'54> — Control The 
Function of the P A2 Key 



DIAGNOSE Code X'54' controls the function of the 
PA2 key. The PA2 key can be used either to simulate 
an external interrupt to a virtual machine or to clear the 
output area of a display screen. 

The function performed depends upon how Rx is 
specified when DIAGNOSE Code X'54' is issued. If 
Rx contains a nonzero value, the PA2 key simulates an 
external interrupt to the virtual machine. If Rx contains 
a value of zero, the PA2 key clears the output area of 
the display screen. 

The external interrupt is simulated only when the 
display screen is in the VM READ, HOLD, or MORE 
status and the TERMINAL APL ON command has 
been issued. 
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DIAGNOSE Code X<58' — 3270 Virtual 
Console Interface 



DIAGNOSE Code X'58' enables a virtual machine to 
communicate with 3270 display stations. Using 
DIAGNOSE Code X'58', a virtual machine may: 

• Display up to a full screen of data using only one 
write operation. 

• Provide attribute characters along with data that is 
sent to the display station. An attribute character 
provides control information for the data, for 
example, a request to intensify the data when it is 
displayed. 

• Place a 3270 display station under control of the 
virtual machine (full screen mode). 

When a virtual machine issues DIAGNOSE Code 
X'58', the virtual machine must provide one or more 
channel command words (CCWs). These CCWs 
specify the 3270 operation to be performed, provide 
control information for the display station, and specify 
the address of data to be displayed during a write 
operation or the address of a buffer where data is to be 
stored during a read operation. If only one CCW is 
used, the Rx register must contain its address. If CCWs 
are chained, the Rx register must contain the address of 
the first CCW in the chain. The Ry register must 
contain the virtual address of the display station where 
the operation is to be performed. This value must be 
right-justified. 
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Displaying Data 



To display up to a full screen of data, code a CCW 
using the following assembler language instructions: 

DS OD 

DC AL 1 ( CCWCODE ), AL3(DATADDR),AL1( FLAGS ),AL1(CTL),AL2( COUNT) 

Where: 

CCWCODE 

the command code X'19\ 

DATADDR 

is the virtual storage address of the first byte of data 
to be displayed. 

FLAGS 

are standard CCW flags. The 
suppress-incorrect-length indicator, bit 34, must be 
set to a value of one. Set other bits as needed. 

CTL 

is a control byte defined as follows: 

• If the high-order bit (bit 0) is on, CP displays 
more status before erasing the display station 
screen and displaying the new data. 

• Bits 2-7 identify the line on the display screen 
where the display is to start. A value of 
(B'xxOO 0000') corresponds to the first or top 
line, a value of 1 (B'xxOO 0001') corresponds to 
the second line and so forth. 

• If the control byte contains the value X'FF', CP 
clears the output area on the display screen. No 
new data is displayed. 

• CCWs may be command chained to combine 
several operations in one DIAGNOSE. If the 
control byte contains a value of X'FE', CP will: 
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— Erase the entire screen. 

— Rewrite the attribute bytes for the CP 
screen format. 

— Reset the cursor to the beginning of the 
input area. 

COUNT 

specifies the number of bytes of data to be 
displayed. The maximum that can be specified for 
this command code is 2032 bytes. 

To provide attribute characters for the data, place the 
attribute character in the data stream immediately 
following a 3270 start-field order. The start-field 
order, a one-byte value, notifies the 3270 display 
system that the next byte in the data stream is an 
attribute character. For a description of how the 3270 
display system uses attribute characters, and to 
determine the values to specify for attribute characters 
and the start-field order, see the IBM 3270 Information 
Display System Component Description. 

After processing DIAGNOSE code X'58', CP sets a 
condition code. If the operation was successful - that 
is, no I/O errors occurred - CP sets a condition code of 
zero. If an I/O error occurred, CP sets a condition 
code of one. 

If an I/O error occurred, the application program can 
check the I/O status and the error type by: 

• Issuing a TEST I/O (TIO) instruction 

• Examining the returned condition code 

• Examining the virtual CSW. 

The returned condition codes and CSW status are the 
standard condition codes and status defined in the IBM 
System/ 3 70 Principles of Operation. 

You must also make sure that the interrupt for the 
virtual device is enabled by setting the appropriate bit 
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and channel mask in the PSW. For example, if the 
virtual address of your console is OIF, bit in the 
channel mask must be set to one (that is, bit must be 
on). This may be the case if you are loading programs 
in the CMS transient area. 



Full Screen Mode 



DIAGNOSE X'58' provides a means by which a virtual 
machine may share, with CP, control of a 3270 display 
station. Two CCW operations, X'29' and X'2A', in 
addition to performing the requested I/O, notify CP 
that the display station is operating under the control of 
the virtual machine. 

CCW code X'29' performs a WRITE, or 
ERASE/WRITE, operation, depending on the value of 
the control field. For the WRITE, and 
ERASE/WRITE, the virtual machine must provide 
appropriate control information beginning with the 
Write Control Character (WCC) and including 3270 
orders following the WCC. Data may be written 
anywhere on the screen. The virtual machine must 
provide the address where the write is to begin; it uses a 
SET BUFFER ADDRESS (SBA) order to do this. 
Writing can also start at the current cursor address. 

CCW code X'2A' performs a READ BUFFER or a 
READ MODIFIED operation, depending on the value 
of the control field. 

To specify the full screen mode CCW, use the following 
assembler language instructions: 

DS 0D 

DC AL 1 ( CCWC0DE),AL3(DATADDR),AL1 (FLAGS ),AL1( CONTROL ),AL2( COUNT) 
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Where: 

CCWCODE 

is a CCW code (X'29' or X'2A') 

DATADDR 

for a write operation, specifies the first byte of the 
data stream (WCC) to be written. For a read 
operation, specifies the address of the read buffer. 

FLAGS 

is the standard CCW flag field. 

CONTROL 

for a write operation, an ERASE/WRITE is 
performed by specifying a ccwcode of X'29', if the 
high-order bit (X'80') is on. 

If the high-order bit (X'80') is on for a read 
operation, a READ MODIFIED is performed; 
otherwise, a READ BUFFER is performed. The 
addition of X'10' to the CONTROL field values for 
ERASE/WRITE making it X'90' causes the PA1 
key interrupt to be reflected to the virtual machine. 
This replaces the normal PA1 key function of 
returning the virtual machine to CP mode. This 
allows a virtual machine to have full control of the 
keyboard. Normal PA1 key function is restored 
when full screen mode is reset. 

COUNT 

for a write operation, specifies the number of bytes 
to be displayed plus the number of bytes of control 
information. For a read operation, specifies the 
number of display characters to be read plus the 
number of bytes of control information. The 
maximum number of bytes that can be specified is 
3000. The maximum number of display able 
positions is 1920. 
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Full Screen Interactions 

The virtual machine console exists in either of two 
modes, CP mode and full screen mode. CP mode is the 
default screen mode and is indicated by the screen 
status field in the lower right-hand corner of the screen. 
When in CP mode, the screen format is controlled by 
CP, and the data that appears on the screen is provided 
by CP and the programs running in the virtual machine. 
Full screen mode is initiated by the application program 
running in the virtual machine. When in full screen 
mode, the screen format and data are under complete 
control of the program running in the virtual machine. 

CP mode is terminated and full screen mode is initiated 
when the application program issues an 
ERASE/WRITE instruction. Full screen mode may be 
terminated by a CP mode type I/O to the screen any 
time the keyboard is in a locked state. 

Interactions between CP and the application program in 
the virtual machine using full screen support are listed 
below. The application programmer must be familiar 
with the operation of the IBM 3270 display station. 
Detailed information on its operation can be found in 
the IBM 3270 Information Display System Component 
Description. Also listed below are general programming 
considerations that must be followed to effectively use 
the DIAGNOSE X'58' instruction for full screen I/O. 

1 . A full screen ERASE/ WRITE operation establishes 
full screen mode. 

2. The application program is responsible for all I/O 
status and error checking, just as if START I/O 
(SIO) were being used instead of DIAGNOSE. 
This is done by using the TEST I/O (TIO) 
instruction and examining the returned condition 
code, and by examining the virtual CSW. The 
returned condition codes and CSW status are the 
standard condition codes and status as defined in 
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the IBM System/ 370 Principles of Operation, with 
one exception noted below in number 3. 

3. When a mode switch has occurred and the screen is 
in CP mode, the application program is notified by 
an X'8E' in the CSW unit status byte following a 
full screen I/O operation. An ERASE/WRITE 
instruction should be issued to reestablish full 
screen mode and reformat the screen. If control of 
the PA1 key interrupt had been transferred to the 
virtual machine via the CONTROL option, it must 
be respecified to return PA1 key control back to the 
virtual machine. Otherwise, depression of the PA1 
key places the display in CP mode. 

An X'8E' in the CSW unit status byte following an 
ERASE/WRITE ALTERNATE instruction 
indicates that non-full screen data (CP mode) is 
waiting to be read. The application program should 
issue a non-full screen READ and then reissue the 
ERASE/WRITE instruction. 

4. Non-full screen virtual machine messages are 
displayed immediately when in full screen mode. 

5. The application program must establish an 
environment to handle attention interruptions. This 
could be done using the CMS macros HNDINT and 
WAITD. An attention interruption to the 
application program when CP receives an attention 
interruption indicating that the virtual machine 
console operator has caused an interruption. (For 
example, depressed the ENTER or a PF key on the 
display keyboard). The application program should 
respond by issuing a READ. 

6. The application program must also establish an 
environment to handle I/O interruptions and must 
ensure that channel end and device end have been 
received before processing continues. 
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7. If the test request key is depressed when in full 
screen mode, X'604040' is returned to the 
application program in the read buffer. 

8. If you press the PA1 key in full screen mode, CP 
posts an attention interrupt to your virtual machine. 
If the virtual machine does not respond with a 
READ and you press the PA1 key a second time, 
your virtual machine is put in CP mode and "CP 
READ" is displayed in the screen's status area. 
However, if you set bit X'10' of the CONTROL 
option on before the initial ERASE/WRITE and 
press the PA1 key, the interrupt is reflected to your 
virtual machine for handling. If you have not set bit 
X'10' of the CONTROL option on and you press 
the PA1 key, your virtual machine is put in CP 
mode and "CP READ" is displayed in the screen's 
status area. 
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DIAGNOSE Code X'5C — Error 
Message Editing 



Execution of DIAGNOSE Code X'5C causes the 
editing of an error message according to the user's 
setting of the EMSG function: 



Rx 



contains the address of the message to be edited. 



Ry 

contains the length of the message to be edited. 

The EMSG options CODE and TEXT are tested, and 
DMKHVC tests the VMMLEVEL field of the 
VMBLOK. Rx and Ry are modified as follows: 



LEVEL 


Registers on Return 


CODE 


TEXT 


Rx 


Ry 


ON 


ON 


no change 


no change 


ON 


OFF 


no change 


10 (length of code) 


OFF 


ON 


pointer to text part of 
message 


length of text alone 


OFF 


OFF 


N/A 






Note: DIAGNOSE Code X'5C does not write the 
message; it merely rearranges the starting pointer and 
length. For CMS error messages, a console write is 
performed following the DIAGNOSE unless Ry is 
returned with a value of 0. 
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DIAGNOSE Code X'60' — Determining 
the Virtual Machine Storage Size 



Execution of DIAGNOSE Code X'60' allows a virtual 
machine to determine its size. On return, the register 
specified as Rx contains the virtual machine storage 
size. 
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DIAGNOSE Code X'64' — Finding, 
Loading, and Purging a Named Segment 

Execution of DIAGNOSE Code X'64' controls the 
linkage of discontiguous saved segments. Since 
VM/PC CP does not support saved segments, the 
function return code to all subcodes will be: 

Return Code Meaning 

44 Named segment does not exist 
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Appendix B, Comparison of VM/PC and 
VM/SP 



Relationship of VM/PC and VM/SP 

VM/PC is based on VM/SP Release 3. VM/PC has 
changed some aspects of VM/SP to fit its environment. 

Externally, some of the commands and command 
options available on VM/PC are not the same as those 
available on a VM/SP system. In addition, some of the 
command response formats may be different from a 
VM/SP system. Some VM/SP commands and options 
are not present in VM/PC, since VM/PC does not 
have support for tape I/O, virtual readers, or virtual 
punches. In addition, the CMS/DOS environment is 
not supported on VM/PC. 

The user control blocks of VM/PC CMS are identical 
in format with those of VM/SP CMS. 

If we examine a typical CMS session, some of the 
differences between VM/PC and VM/SP can be 
pointed out and explained. 

• Logon screen 

You don't have to clear the system logo in order to 
log on to VM/PC. In addition, you may specify an 
environment to start or you may have a default 
environment, specified in your system configuration 
file. 
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CP Commands 

CP commands that are allowed to have multiple 
operands in VM/SP (for example, DISPLAY) will 
be allowed only one operand by VM/PC CP. 

CMS Initialization 

When you start (IPL) CMS, you may pass a 
parameter on the command line. If you specify the 
environment on the logon screen or in the autoipl 
configuration option, the system will pass the 
parameter 'AUTOIPL'. VM/PC CMS does not 
prompt you for a first command, as VM/SP CMS 
does. The initialization of CMS continues, 
uninterrupted by a prompt. 

The initialization of CMS involves accessing the 
'100' minidisk as your S disk. Only the mode S2 
files will be accessed. The initialization of CMS 
then checks to see if an exec called 'SYSPROF 
EXEC exists on this S-disk. If it does, the 
command 'EXEC SYSPROF' is executed and the 
parameter passed to CMS on the IPL command is 
passed to this exec. 

The SYSPROF EXEC checks for the parameter 
'NOSPROF', which you specify if you don't want 
the system profile to be executed. If you specify 
'NOSPROF', the exec ends without doing anything 
else. Otherwise, the exec issues the command 'SET 
OSSIM ON' to start OS Simulation, and sets the 
system synonyms from the file 'SYSTEM 
SYNONYM' on the S-disk. 

If you have a minidisk defined at address '101', that 
disk is accessed as your A-disk. If you have a 
minidisk defined as '10E', that disk is accessed as 
your Y-disk. Unlike VM/SP, the Y disk will not be 
selectively accessed. 

If you specified the keyword 'NOPROF' on the IPL 
of CMS, your user profile is not executed. If you 
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didn't specify 'NOPROF', the file 'PROFILE 
EXEC is executed. The parameters you used to 
start CMS are passed to your profile exec, where 
you may test for special keywords. 

This initialization is similar to the way VM/SP 
initializes, although it is not identical. The 
initialization of CMS in VM/PC is less complex, 
and allows you to tailor your CMS environment for 
special requirements you may have. 

Screen format 

The screen format of VM/PC is similar to that of 
VM/SP, although it is not identical. The scroll field 
at the bottom right of the screen allows you to 
scroll back through the contents of the terminal 
history buffer. In addition, VM/PC has two 
additional options on the CP TERMINAL 
command, which allow you to control the action of 
the PA2 key and the display of information lines 
longer than the width of the screen. Also, the VM 
status area on the lower right of the screen differs 
from that of VM/SP. It will indicate 'Waiting' 
when the system is not actually doing work for you 
and is waiting for you to enter a command. The 
CMS prompt 'Ready;' is also slightly different than 
that of VM/SP. 

CMS messages 

Most messages VM/PC CMS will display to you 
are in mixed case, unlike the messages displayed by 
VM/SP. In addition, the text of these messages 
comes from a system message file which is on the 
S-disk. 

Commands do not support tape drives, virtual 
readers, or punches. 

The support for these devices is not present in 
VM/PC, and commands which support these 
devices are not present. 
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IDENTIFY command output 

Since there is no RSCS virtual machine on your 
VM/PC, the fields in the IDENTIFY command 
output which indicate node and userid of the RSCS 
virtual machine are filled with token placeholders of 
'*'. Also, since you set the timer of your VM/PC, 
the time zone is designated as 'LOCAL' in the 
command output. 

CMS Maclibs 

The macro libraries which are on the CMS 100 
minidisk contain a subset of the macros available on 
a VM/SP CMS system. The CMS and OS maclibs 
are named 'CMSPCLIB MACLIB' and 'OSPCLIB 
MACLIB', respectively. 

I/O interface changes. 

VM/SP CMS uses the SIO instruction to support 
the console. Since VM/PC does not support this 
instruction, VM/PC CMS has changed the console 
support to use the DIAGNOSE X'20' support in 
VM/PC CP. 

Storage Keys 

Although storage protection is not performed, the 
storage keys have been retained to provide 
compatibility for programs that use the storage keys 
to determine system and user area partitioning. 

Interval Timer 

Since VM/PC does not support the interval timer, 
the timer routines in OS Simulation have been 
modified to use the CPU timer. 

File System 

You cannot create or access local minidisks 
formatted in 800-byte blocks. You may access host 
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minidisks formatted at this size, however. VM/PC 
supports CMS minidisks in 512, 1024, 2048, and 
4096-byte sizes. VM/PC chose these as the best 
sizes for minidisks, since they must be mapped into 
Personal Computer DOS files, which are 
maintained in 512 byte blocks. 

In addition, the support for host minidisks and host 
files has changed the CMS file system somewhat. 
The FSTs for host minidisks which you access are 
not copied to your local session storage. Rather, all 
requests for file system functions are sent to the 
host server program. The results of these requests 
are passed back to you as if the files and disks were 
locally attached. Some of the fields in the internal 
file system tables ADT and AFT are used 
differently when the minidisk or file is located at 
the host. 

NUCXLOAD Command 

The NUCXLOAD command in VM/PC is 
different from that of VM/SP. The VM/PC 
command is located in the CMS nucleus, and 
supports the loading of modules which are adcon 
free and those which have their RLD information 
saved with the module, through the use of the 
'RLDSAVE' option of LOAD and INCLUDE. 
Also, the NUCXLOAD command doesn't support 
loading of modules from OS LOADLIBs, as this 
support does not exist in VM/PC. 

XEDIT and EXECIO Initialization 

Both XEDIT and EXECIO are initialized 
differently in VM/PC than in VM/SP. Both 
programs make use of the capabilities of the 
NUCXLOAD command to load the programs as 
nucleus extensions. After the first invocation of 
these commands, the nucleus extension will 
normally be used when you invoke the command. In 
addition, OS Simulation uses this capability to load 
the OSSIM module into your virtual storage to 
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provide the capabilities of OS Simulation in your 
CMS environment. 

XEDIT 

In addition to the difference in the initialization of 
XEDIT, the messages and screen format of XEDIT 
use mixed case to facilitate the reading of 
information. Also, the default PF keys for XEDIT 
set the PF1 key to TOP' rather than 'HELP', since 
the HELP facility does not exist on VM/PC. 

FILELIST 

The defined PF keys for FILELIST set the PF1 key 
to 'SORT on name' instead of HELP. 

Simplification 

— Command Interpreter Simplification 

VM/PC has simplified the CMS command 
interpreter to eliminate infrequently used 
options in favor of greater performance. For 
instance, the BLIP capability has been removed. 

- VM/PC has removed the SVCTRACE 
capability, since the VM/PC CP TRACE 
command provides an advanced trace capability 
which allows tracing SVC execution in CMS. 



Moving Application Programs from VM/SP to 
VM/PC 

It is expected that application programs to be run on 
VM/PC will be either downloaded from a host system 
or developed to run on both a VM/PC and a host 
system. Once the desired application has been installed 
on VM/PC (by whatever means), VM/PC can 
function alone as long as the application has no need of 
the host system. 
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VM/SP Commands Not Supported in 
VM/PC 



The following VM/SP 3 CMS commands are not 
supported: 



AMSERV 


HELP 


PUNCH 


ASSEMBLE 


LABELDEF 


RDR 


ASSGN 


LISTDS 


RDRLIST 


CATCHECK 


LISTIO 


READCARD 


CMSBATCH 


LKED 


RECEIVE 


DDR 


LOADLIB 


RSERV 


DISK 


MOVEFILE 


RUN 


DLBL 


NAMEFIND 


SENDFILE 


DOSLIB 


NAMES 


SETPRT 


DOSLKED 


NOTE 


SSERV 


DSERV 


OPTION 


SVCTRACE 


EDIT 


OSRUN 


TAPE 


ESERV 


PEEK 


TAPEMAC 


FETCH 


PSERV 


TAPPDS 
TELL 
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Finding Further Information in VM/SP 
Library 



You can find further information about using VM/PC 
in the VM/SP Release 3 library. We list the names and 
order numbers of those books below. 

Note: When seeking further information for using 
VM/PC in the VM/SP library, remember that those 
books were written for VM/SP users and contain 
information about features and functions not supported 
in VM/PC. Keep in mind the differences listed earlier 
in this appendix when consulting the VM/SP library. 

Here's a table to help you find specific information in 
the VM/SP library: 



Information Sought 


VM/SP Book to Look In 


System Product Editor 
(XEDIT) Use 


SP Editor User's Guide 


System Product Editor 
(XEDIT) Commands 


SP Editor Command 
Reference 


Restructured Extended 
Executor (REXX) 
Language Use 


System Product 
Interpreter User's Guide 


Restructured Extended 
Executor (REXX) 
Language Commands 


System Product 
Interpreter Reference 


CMS Messages 


System Messages and 
Codes 
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Information Sought 


VM/SP Book to Look In 


CMS Commands 


CMS Commands and 
Macros 


EXEC 2 Use 


EXEC 2 Reference 


EXEC Use 


CMS User's Guide 


Writing application 
programs for VM/SP 


Application 
Development Guide 
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Order Numbers for VM/SP Release 3 
Books 



The order numbers for the VM/SP Release 3 books 
are: 



Introduction, GT00-1349 

System Programmer's Guide, ST00-1352 

System Messages and Codes, ST00-1353 

Terminal Reference, GT00-1355 

CMS Command and Macro Reference, ST00-1357 

CMS User's Guide, STOO-1358 

System Product Editor User's Guide , SQ24-5220 

System Product Editor Command and Macro 

Reference, ST00-1369 

EXEC 2 Reference, ST00-1368 

System Product Interpreter User's Guide , ST24-5238 

System Product Interpreter Reference, ST24-5239 

Data Areas and Control Block Logic, Volume 2 

(CMS), LT64-5221 

System Logic and Problem Determination Guide, 

Volume 2 (CMS), LT00-1367 

Quick Guide for Users, ST00-1363 

Command Summary (General Users), ST00-1364 

System Product Editor Command Reference 

Summary, ST00-1370 

EXEC 2 Language Reference Summary, ST00-1572 

Application Development Guide, ST24-5247 
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Appendix C. Operating Hints 



Backing up Minidisks 

VM/PC minidisks are managed as files with a 
"filename. extension" of "userid. device address" and 
may exist on either a fixed disk drive, or a diskette 
drive. You may wish to periodically back-up your 
minidisks to prevent data loss or for security reasons. 
Since a minidisk is a DOS file, it may be backed up with 
any of the backup facilities available with DOS. 



Minidisks on Diskettes 

If you define a minidisk on a diskette drive, you should 
not remove the diskette while a command is executing. 
You should wait for all commands you have issued to 
complete before removing the diskette from the drive. 
In addition, any time you insert such a minidisk in the 
drive, issue the ACCESS command to update the 
virtual storage copy of the new minidisk's directory. 

Also, if the CMS minidisk to be used does not yet exist 
on the diskette, you should issue the CP LINK 
command, prior to using the CMS minidisk, to ensure 
that the proper DOS file allocation takes place on the 
diskette prior to your using the minidisk. Failure to do 
this may result in unreadable data on the diskette. 
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Transporting CMS Files 

There are two methods of transporting CMS files 
between VM/PC systems. The first uses the EXPORT 
and IMPORT commands; the second uses a minidisk 
defined on a diskette. 

EXPORT/IMPORT Method 

The file to be transported is EXPORTed to a diskette 
(the Personal Computer DOS filespec is given as an 
operand of the EXPORT command). The diskette is 
then carried to another system and the IMPORT 
command is used to load the file. This method should 
be used only to transport character data files. 

Minidisk Method 

Your configuration file must include a definition for a 
minidisk on your diskette drive. Since minidisks are 
files whose names are in the form "userid. device 
address", it is helpful to have a common userid on both 
systems with identical minidisk definitions. This userid 
need not be the one that you use normally, but you 
must be able to link to that minidisk in R/W mode (it 
might be preferable to use a separate userid for the 
diskette minidisk because your logon will take 
considerably longer if the diskette drive is empty or 
open). 

The file to be transported is copied onto the diskette 
minidisk with the COPYFILE command and when the 
command is completed, the diskette may be removed 
and transported to another system. (If the userids and 
device addresses do not match, as suggested above, the 
minidisk file must be renamed accordingly.) The 
minidisk can then be accessed and the file can be 
copied to any other minidisk. 
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File Access Performance 

As with any Personal Computer DOS file, the files used 
by VM/PC are subject to performance degradation if 
they are fragmented (records not allocated 
contiguously). The Personal Computer DOS CHKDSK 
command can be used to determine if a file is 
fragmented. 

Contiguous record allocation is extremely important for 
the paging file. Since it is normally deleted when you 
logoff, you will have to terminate VM/PC (using 
CTRL-BREAK) with the Local 3270 Session still 
active. You can then use the CHKDSK command to 
determine whether the paging file is fragmented. 

If you suspect that a fragmented file is causing a 
performance problem, you can eliminate the 
fragmentation by using the Personal Computer DOS 
COPY command to copy the file to another disk, or by 
using the DOS BACKUP command to move all files 
from a hard disk to diskettes. If you use BACKUP, you 
then: 

1. Use the DOS FORMAT command to format the 
disk you moved from. 

2. Use the DOS RESTORE command to return the 
files to the original disk. 

(For a performance problem, see also "Using DOS 
Features," which follows.) In the case of the paging 
file, which is allocated by VM/PC during its execution, 
all files on the drive where the paging file resides should 
be copied; this will remove small areas of unused space 
that can result in a fragmented paging file. 
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Using AT/370 RAM with VM/PC 



With an AT/370 you can have expansion Random 
Access Memory (RAM) in your System Unit. There 
are any number of ways you could use this memory 
advantageously. Here are two examples of using it to 
create Personal Computer DOS VDISKs to use with 
VM/PC. 

Note: Remember that this expansion RAM space 
should only be used as working space (not storage 
space) since it is erased each time your system is 
re-booted or turned off. Remember also that DOS 
version 3.00 (or its equivalent) is required. 



Example of Using DOS VDISK as CMS 
Minidisk with VM/PC 

To use the expansion RAM space on an AT/370 as a 
minidisk for VM/PC, enter Personal Computer DOS 
(Version 3) and: 

1. Create (or modify) the Personal Computer DOS 
file named CONFIG.SYS on the boot disk (for 
example, C). 

2. Add this line to the CONFIG.SYS file: 

dev ice^vd \ sk . sys 256 512 16 /e 

This command tells DOS to create a 25 6K VDISK 
with 5 12-byte sectors. (You will have 512 blocks 
of 512-bytes each.) The one sector used as a 
directory holds 16 entries. The /e indicates you 
want the device on expansion memory. 

3. Re-boot DOS (press Ctrl-Alt-Del) so DOS will 
create the VDISK when it starts. DOS assigns the 
next-available drive letter to the VDISK. Thus, if 
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you have a system with 2 fixed disks (C and D), 
DOS assigns drive letter E to the VDISK. Note the 
letter DOS assigns to the VDISK. 

4. Identify the VDISK as a minidisk to VM/PC. Type 
the VMPCCON command to enter the VM/PC 
Configurator. Define the minidisk on the 'Update 
Minidisk for User' menu. Use the same Drive ID 
DOS assigned to the VDISK. In our example, you 
would type 508 as the "size of minidisk," since 4 
blocks are used for System information. (The 
Configurator will help you if you specify too many 
blocks.) 

5. Leave the Configurator (saving updates) and type 
VMPC to start VM/PC. VM/PC will allocate the 
VDISK and you must format it. After each power 
down or re-boot, you will have to format your 
VDISK-resident minidisk before you can use it. 



Example of Using DOS VDISK as VM/PC 
Paging File 

To place your VM/PC Paging File (PAGE.1VM) on a 
DOS VDISK defined on expansion RAM on an 
AT/370, follow these steps in Personal Computer DOS 
(version 3): 

1. Create (or modify) the Personal Computer DOS 
file named CONFIG.SYS on the boot disk (for 
example, C): 

2. Add this line to the CONFIG.SYS file: 

device=vdisk.sys 1024 512 16 /e 

This creates a 1024K VDISK with 512-byte 
sectors. The one sector used as a directory holds 16 
entries. The /e indicates you want the device on 
expansion memory. 
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3. Re-boot DOS (press Ctrl-Alt-Del). DOS will create 
the VDISK when it starts. DOS assigns the 
next-available drive letter to the VDISK. Note the 
drive letter DOS assigns to the VDISK. 

4. Type the VMPCCON command to enter the 
VM/PC Configurator. On the "Update System 
Configuration" menu change the filespec of field 6, 
the Page Dataset, from 'C:PAGE.1VM' to 
'E:PAGE.1VM\ (This example assumes it was on 
disk C and your new VDISK is E. If different, 
change accordingly.) 

5. Leave the Configurator (saving updates) and type 
VMPC to start VM/PC. VM/PC will allocate a 
PAGE.1VM file of up to 1022K bytes (2K bytes 
will be used for system information on the VDISK). 

Note: DOS VDISKs may be defined in other sizes, up 
to a maximum of 1.5 megabytes. 

For further information on expansion RAM on an 
AT/370, see the Personal Computer AT/ 370 Guide to 
Operations publication. 

Sample EXEC to Access a VDISK Automatically 

The following EXEC (written in EXEC 2) accesses a 
VDISK, formats it (if necessary), and displays any files 
on the VDISK or tells you there are no files on the 
VDISK. 

Create the exec as shown below. Give it a filename of 
VDISK and filetype of EXEC. Note that we have used 
484 as the address of the VDISK, T as its mode, and 
T484 as its label. Change the appropriate lines of the 
EXEC to match your VDISK values. (Do not type the 
"Replace..." instructions.) 



u-b vivi/r^ user s ouiae 



&TRACE OFF 

CP SET EMSG OFF 

CP SET IMSG OFF 

CP Q, kSk (Replace hSk with address of your VDISK) 

&IF &RC = kO &EXIT 

ACC 484 T (Replace 484 and T with your address and mode) 

LISTFILE * * t (Replace T with your VDISK filemode) 

&IF &RC = 36 &G0T0 -FORMAT 

&IF &RC = 28 &G0T0 -NOFILES 

&IF &RC = &EXIT 

&EXIT 

-FORMAT 

&STACK YES 

&STACK T484 (Replace T484 with your VDISK label) 

FORMAT 484 T (NOERASE (Replace 484 and T as above) 

-NOFILES 

&TYPE NO FILES EXIST ON THE VDISK 

&EXIT 

After you have filed VDISK EXEC, you can add the 
line 

EXEC VDISK 

as the next-to-last statement of your PROFILE EXEC. 
After that, each time you start a local VM/PC session 
VDISK EXEC will execute, and access and format the 
VDISK for you. 



Using DOS Features 



DOS tree-structured directories can be used for the files 
needed to run VM/PC. However, when installing 
VM/PC, all the files are copied to the root directory. 
If you wish to set up another DOS directory for your 
VM/PC files, you will need to copy (using the DOS 
COPY command) the VM/PC files to the desired 
directory. After doing so, you can erase the VM/PC 
files from the root directory if you wish. 

Both VM/PC and DOS provide facilities for printing 
files while executing other tasks. When VM/PC is 
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running, it attempts to control the printer for its own 
printer spooling functions. For this reason, the DOS 
PRINT command queue should be empty prior to 
invoking VM/PC. 

Certain DOS commands can be used to configure your 
system. One of these, the BUFFERS command, is used 
to set the number of buffers DOS is to reserve at 
startup time. The number chosen can significantly 
affect the performance of programs running under 
VM/PC. To find the value best for you, we suggest 
you measure the performance of your most frequently 
used VM/PC applications with the number of buffers 
set to several different choices. While there is no one 
number that is best for all programs, a choice of 
between 1 8 and 20 buffers is recommended as a 
starting point for an AT/370, and between 10 and 15 
for an XT/370. 



FORMAT Command Performance 

The performance of the CMS FORMAT command can- 
be improved by the use of the NOERASE option. 
Normally, the FORMAT command will clear all of the 
blocks of the minidisk to zeros. When formatting a 
CMS minidisk with the NOERASE option, the blocks 
are not cleared, and the performance of the command is 
improved. The NOERASE option should not be used if 
previous data on the minidisk should be cleared to 
zeros. 



Host Minidisks 



Host minidisks are used in command resolution the 
same way that local minidisks are. The performance of 
command resolution may be improved if you access 
host minidisks lower in your search order than the 
S-disk. This is of course dependent on the actual 
commands you are using, and where VM/PC must look 
to resolve the commands. 
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For example, if something on your S disk (which is 
local) is also on a host disk accessed earlier than S, the 
system will use the host disk's copy, thereby degrading 
performance. 



Spool Files 



Whenever VM/PC is asked to print a file on the local 
printer, a spool file is created on disk and given the 
DOS filespec of SPOOL.nnn, where nnn is a number in 
the range from 1 to 999. Also, in order to manage the 
spool files, VM/PC creates two control files, 
SPOOLIN.DEX and SPOOLSF.BLK. 

If you were to erase either of the control files before 
VM/PC has completed all printing activity, any 
unprinted spool files would be lost. New control files 
will, however, be created by VM/PC if local printing is 
requested and existing control files cannot be found. 

Should you ever wish to move spool files from one 
VM/PC system to another VM/PC system, you will 
need to move the two control files also, as VM/PC 
cannot process the spool files without the control files. 
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Appendix D. ASCII to EBCDIC 
Conversion 



The VM/PC programs use the following table when in 
3277 Emulation Mode to translate VM/PC CMS 
EBCDIC format data to ASCII format data whenever 
necessary. 



EBCDIC 


ASCI I 


EBCDIC 


ASCI I 


VALUE 


= VALUE 


VALUE 


= VALUE 


HEX DEC 


HEX 


DEC 


HEX DEC 


HEX DEC 


00 


00 





IE 


30 


1E 


30 


01 1 


01 


1 


1F 


31 


1F 


31 


02 2 


02 


2 


20 


32 


20 


32 


°ol I 


03 


3 


21 


11 


20 


32 


20 


32 


22 


1C 


28 


05 5 


09 


9 


11 


35 


20 


32 


06 6 


20 


32 


36 


20 


32 


07 7 


7F 


127 


25 


37 


OA 


10 


08 8 


20 


32 


26 


38 


17 


23 


09 9 


20 


32 


27 


11 


1B 


27 


0A 10 


20 


32 


28 


20 


32 


0B 11 


0B 


11 


29 


41 


20 


32 


0C 12 


OC 


12 


2A 


42 


20 


32 


0D n 
0E \k 


0D 
0E 


\i 


2B 
2C 


a 


20 
20 


32 
32 


OF 15 


OF 


15 


2D 


45 


05 


5 


10 16 


10 


16 


2E 


46 


06 


6 


11 17 


11 


17 


2F 


47 


07 


7 


12 18 


12 


18 


30 


48 


20 


32 


13 19 

14 20 


13 


19 


31 


49 


20 


32 


20 


32 


32 


50 


16 


22 


15 21 


20 


32 , 


11 


51 


20 


32 


16 22 


08 


8 


52 


20 


32 


17 2} 

18 2k 


20 


32 


35 


S 


20 


32 


18 


24 


36 


20 


32 


19 25 


19 


25 


37 


55 


04 


4 


1A 26 


20 


32 


38 


56 


20 


32 


1B 27 


20 


32 


39 


57 


20 


32 


1C 28 


20 


32 


3A 


58 


20 


32 


1D 29 


1D 


29 


3B 


59 


20 


32 
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EBCDIC 


ASCI I 


EBCDIC 


ASCI 1 


VALUE 


= VALUE 


VALUE 


= VALUE 


HEX DEC 


HEX 


DEC 


HE> 


, DEC 


HEX DEC 


3C 60 


14 


20 


6D 


109 


5F 


95 


3D 61 


15 


21 


6E 


110 


3E 


62 


3E 62 


20 


32 


6F 


111 


3F 


63 


lo d 

41 65 


1A 


26 


70 


12 


20 


32 


20 
20 


32 
32 


71 
72 


\\i 


20 
20 


32 
32 


42 66 


20 


32 


H 


115 


20 


32 


43 67 

44 68 


20 


32 


16 


20 


32 


20 


32 


75 


117 


20 


32 


45 69 


20 


32 


76 


18 


20 


32 


46 70 


20 


32 


77 


19 


20 


32 


47 71 


20 


32 


78 


1 20 


20 


32 


48 72 


20 


32 


79 


21 


20 


32 


49 73 
4A 74 


20 


32 


7A 


22 


3A 


58 


9B 


'it 


7B 


11 


23 


11 


4B 75 


2E 


7C 


ko 


4C 76 


3C 


60 


7D 


25 


27 


39 


4D 77 


28 


40 


7E 


26 


3D 


61 


4E 78 


2B 


43 


7F 


27 


22 


34 


4F 79 


B3 


179 


80 


28 


20 


32 


50 80 


26 


38 


81 


29 


61 


97 


51 81 


20 


32 


82 


30 


62 


98 


52 82 


20 


32 


11 


31 


12 


90 


11 U 


20 


32 


32 


100 


20 


32 


85 


11 


65 


101 


55 85 


20 


32 


86 


66 


102 


56 86 


20 


32 


87 


35 


67 


103 
104 


57 87 


20 


32 


88 


36 


68 


58 88 


20 


32 


89 ' 


37 


69 


105 


59 89 


20 


32 


8A 


38 


20 


32 


5A 90 


21 


33 


8B 


11 


7B 


123 


5B 91 


2k 


3& 


8C < 


F3 


243 


5C 92 


2A 


42 


8D 


41 


20 


32 


5D 93 
5E 94 


29 


41 


8E 


42 


20 


32 


3B 


59 


8F 


U 


C5 


197 


5F 95 


AA 


170 


90 i 


20 


32 


60 96 


2D 


(♦5 


91 


45 


6A 


106 


61 97 


2F 


46 


92 


46 


6B 


107 


62 98 


20 


32 


l\ 


47 


6C 


108 


63 99 
6k 100 


20 


32 


48 


6D 


109 


20 


32 


95 


49 


6E 


110 


65 101 


20 


32 


96 


50 


6F 


110 


66 102 


20 


32 


97 


51 


70 


112 


67 103 

68 ]0k 


20 


32 


98 


52 


71 


113 
114 


20 


32 


99 


U 


72 


69 105 


20 


32 


9A 


20 


32 


6A 106 


20 


11 


9B 


55 


7D 


175 


6B 107 


2C 


9C 


56 


20 


32 


6C 108 


25 


37 


9D 


57 


20 


32 
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EBCDIC ASCII 
VALUE = VALUE 
HEX DEC HEX DEC 



9E 158 

9F 159 

AO 160 

A1 161 

A2 162 

A? 163 

A4 164 

A5 165 

A6 166 

A7 167 

A8 168 

A9 169 

AA 170 

AB 171 

AC 172 

AD 173 

AE 174 

AF 175 

BO 176 

B1 177 

B2 178 

B3 179 

B4 180 

B5 181 

B6 182 

B7 18 

B8 18 

B9 185 

BA 186 

BB 187 

BC 188 

BD 189 

BE 190 

BF 191 

CO 192 

C1 19 

C2 19 

C3 195 

C4 196 

C5 197 

C6 198 

C7 199 

C8 200 

C9 201 

CA 202 

CB 203 

CC 204 

CD 205 

CE 206 



F1 


241 


FE 


254 


20 


32 


7E 


126 


?? 


115 


116 


75 


117 


76 


118 


77 


119 


78 


120 


79 


121 


7A 


122 


20 


32 


CO 


192 


DA 


218 


5B 


242 


F2 


F9 249 


20 


32 


20 


32 


20 


32 


20 


32 


20 


32 


20 


32 


20 


32 


20 


32 


20 


32 


20 


32 


20 


32 


D9 


217 


BF 


191 


5D 


93 


20 


32 


C4 


196 


7B 


123 


41 


65 


42 


66 


« 


67 


68 


!»5 


69 


46 


70 


47 


71 


48 


72 


49 


73 


20 


32 


20 


32 


20 


32 


20 


32 


20 


32 



EBCDIC 


ASCI I 


VALUE 


= VALUE 


HEX DEC 


HEX DEC 


CF 207 


20 


32 


DO 208 


7D 


'?? 


D1 209 


4A 


D2 210 


4B 


75 


D3 211 
D4 212 


4C 


76 


4D 


77 


D5 213 
D6 214 


4E 


78 


4F 


79 


D7 215 


50 


80 


D8 216 


51 


81 


D9 217 


52 


82 


DA 218 


20 


32 


DB 219 


20 


32 


DC 220 


20 


32 


DD 221 


20 


32 


DE 222 


20 


32 


DF 223 
EO 224 


20 


32 


5C 


92 


E1 225 


20 


32 


E2 226 
E3 227 
E4 228 


u 


k 


55 


& 


E5 229 


56 


86 


E6 230 


57 


87 


E7 231 


58 


88 


E8 232 


59 


89 


E9 233 
EA 234 


5A 


90 


20 


32 


EB 235 


20 


32 


EC 236 


20 


32 


ED 237 


20 


32 


EE 238 


20 


32 


EF 239 
FO 240 


20 
30 


U 


F1 241 


31 


49 


F2 242 


32 


50 


F4 244 


11 


51 
52 


F5 245 


35 


u 


F6 246 


36 


F7 247 


37 


55 


F8 248 


38 


56 


F9 249 


39 


57 


FA 250 


20 


32 


FB 251 


20 


32 


FC 252 


20 


32 


FF 253 
FE 254 


20 


32 


20 


32 


FF 255 


20 


32 
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The VM/PC programs use the following table when in 3277 
Emulation Mode to translate ASCII format data to VM/PC CMS 
EBCDIC format data whenever necessary. 



ASCI 1 


EBCDIC 


ASCI I 


EBCDIC 


VALUE 


= VALUE 


VALUE 


= VALUE 


HEX DEC 


HEX 


DEC 


HEX DEC 


HEX DEC 


00 


00 





27 


11 


7D 


125 


01 1 


01 


1 


28 


4D 


77 


02 2 


02 


2 


29 


41 


5D 


93 


°ol I 


03 


3 


2A 


k2 


if 


92 


37 


n 


2B 


8 


78 


05 5 


2D 


2C 


6B 


107 


06 6 


2E 


46 


2D 


45 


60 


96 


07 7 


2F 


47 


2E 


46 


4B 


75 


08 8 


16 


22 


2F 


47 


61 


240 


09 9 


05 


5 


30 


48 


FO 


0A 10 


25 


37 


31 


49 


F1 


241 


0B 11 


0B 


11 


32 


50 


F2 


242 


0C 12 
0D n 
0E ]k 


OC 
0D 


12 


11 


51 
52 


S 


243 
244 


0E 


35 


M 


F5 


245 


OF 15 


OF 


15 


36 


F6 


246 


10 16 


10 


16 


37 


55 


F7 


247 


11 17 


11 


17 


38 


56 


F8 


248 


12 18 


12 


18 


39 


57 


F9 


249 


13 19 
)k 20 


13 


19 


3A 


58 


7A 


122 


3C 


60 


3B 


59 


11 


94 


15 21 


3D 


61 


3C 


60 


76 


16 22 


32 


50 


3D 


61 


7E 


126 


17 2} 

18 2k 


26 


38 


3E 


62 


6E 


110 


18 


24 


11 


a 


6F 


111 


19 25 


19 


25 


7C 


124 


1A 26 


3F 


63 


41 


65 


C1 


193 
\3k 


1B 27 


27 


11 


k2 


66 


C2 


1C 28 


22 


11 


67 


a 


195 


1D 29 


1D 


29 


68 


196 


1E 30 


1E 


30 


45 


69 


C5 


197 


1F 31 


1F 


31 


46 


70 


C6 


198 


20 32 


ko 


64 


k7 


71 


C7 


199 


21 3** 

22 3^ 


5A 


90 


ii8 


72 


eft 


200 


7F 


127 


4§ 


a 


C9 


201 


23 35 
2k 36 


7B 


123 


4A 


D1 


209 


5B 


91 


4B 


75 


D2 


210 


25 37 


6C 


108 


4c 


76 


11 


211 


26 38 


50 


80 


4d 


77 


212 



D-4 VM/PC User's Guide 



ASCI I 

VALUE 

HEX DEC 



EBCDIC 

VALUE 

HEX DEC 



ASCI I 

VALUE 

HEX DEC 



EBCDIC 

VALUE 

HEX DEC 



kf 
50 
51 
52 

n 
u 

59 

5A 

5B 

5C 

5D 

5E 

5F 

60 

61 

62 

6 

6 

65 

66 

67 

68 

69 

6A 

6B 

6C 

6D 

6E 

6F 

70 

71 

72 

11 
?i 

77 
78 
79 
7A 
7B 
7C 
7D 
7E 



78 

P 
80 

81 

82 

U 

u 

87 
88 
89 
90 
91 
92 

11 

96 

98 
99 
100 
101 
102 
10 
10 
105 
106 
107 
108 
109 
110 
111 
112 
11 
11 
115 
116 
117 
118 
119 
120 
121 
122 
12 
12 
125 
126 



D5 213 
D6 2 1 4 

D7 215 
D8 216 
D9 217 
E2 226 
E3 227 
E4 228 
E5 229 
E6 230 
E7 231 
E8 232 
E9 233 
AD 173 
E0 224 
BD 189 
5F 95 
6D 109 
4A Ik 

81 129 

82 130 

83 131 
8k 132 

85 133 

86 13^ 

87 135 

88 136 

89 137 

91 if 5 

92 146 

93 147 

94 148 

95 149 

96 150 

97 151 

98 152 

99 153 
A2 162 
A3 163 
A4 164 
A5 165 
A6 166 
A7 167 
A8 168 
A9 169 
8B 139 
4F 79 
9B 155 
A1 161 



7F 

80 

81 

82 

8 

8 

85 

86 

87 



§ 9 
8A 

8B 

8C 

8D 

8E 

8F 

90 

91 

92 

U 

u 

3 l 
98 

99 
9A 
9B 
9C 
9D 
9E 
9F 
AO 
A1 
A2 

A7 
A8 
A9 
AA 
AB 
AC 
AD 
AE 
AF 



27 


07 


7 


28 


00 





29 


00 





30 


00 





31 


00 





32 


00 





11 


00 





00 





35 


00 





36 


00 





37 


00 





38 


00 





39 


00 





4o 


00 





k] 


00 





kz 


00 





8 


00 





00 





45 


00 





kt> 


00 





47 


00 





k8 


00 





k3 


00 





50 


00 





51 


00 





52 


00 


b 


11 


00 





00 





55 


^A 


7^ 


56 


00 





57 


00 





58 


00 





59 


00 





60 


00 





61 


00 





62 


00 





U 


00 





00 





65 


00 





66 


00 





67 


00 





68 


00 





69 


00 





70 


5F 


95 


71 


00 





72 


00 





U 


00 





00 





75 


00 
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ASCI I 

VALUE 

HEX DEC 



EBCDIC 

VALUE 

HEX DEC 



BO 176 
B1 177 
B2 178 



] l 3 
180 



B5 181 
B6 182 
B7 183 
B8 184 
B9 185 
BA 186 
BB 187 
BC 188 
BD 189 
BE 190 
BF 191 
CO 192 
CI 19 
C2 19 
C3 195 
C4 196 
C5 197 
C6 198 
C7 199 
C8 200 
C9 201 
CA 202 
CB 203 
CC 204 
CD 205 
CE 206 
CF 207 
DO 208 
D1 209 
D2 210 
D3 211 
D4 212 
D5 21 
D6 21 
D7 215 



00 

00 

00 

4F 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

BC 188 

AB 171 

00 

00 

00 

BF 191 

8F 143 

00 



00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 



ASCI I 


EBCDIC 


VALUE 


= VALUE 


HEX DEC 


HEX DEC 


D8 216 


00 





D9 217 


BB 


187 


DA 218 


AC 


172 


DB 219 


00 





DC 220 


00 





DD 221 


00 





DE 222 


00 





DF 223 
EO 224 


00 





00 





E1 225 


00 





E2 226 


00 





E3 227 
E4 228 


00 





00 





E5 229 


00 





E6 230 


00 





E7 231 


00 





E8 232 


00 





E9 233 
EA 23^ 


00 





00 





EB 235 


00 





EC 236 


00 





ED 237 


00 





EE 238 


00 





EF 239 
FO 240 


00 





00 





F1 241 


9E 


158 


F2 242 


AE 


174 


F3 243 

F4 244 


8C 


140 


00 





F5 245 


00 





F6 246 


00 





F7 247 


00 





F8 248 


A1 


161 


F9 249 


AF 


175 


FA 250 


00 





FB 251 


00 





FC 252 


00 





FF 253 
FE 25^ 


00 





9F 


159 


FF 255 


00 
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The VM/PC programs use the following table when in 
3278/3279 Emulation Mode to translate VM/PC CMS EBCDIC 
format data to ASCII format data whenever necessary. 



EBCDIC 


ASCI I 


EBCDIC 


ASCI I 


VALUE 


= VALUE 


VALUE 


= VALUE 


HEX DEC 


HEX 


DEC 


HEX DEC 


HEX DEC 


00 


00 





26 


38 


17 


23 


01 1 


01 


1 


27 


11 


1B 


27 


02 2 


02 


2 


28 


20 


32 


$ i 


03 


3 


29 


41 


20 


32 


20 


32 


2A 


42 


20 


32 


05 5 


09 


9 


2B 


8 


20 


32 


06 6 


20 


32 


2C 


20 


32 


07 7 


7F 


127 


2D 


45 


05 


5 


08 8 


20 


32 


2E 


46 


06 


6 


09 9 


20 


32 


2F 


47 


07 


7 


0A 10 


20 


32 


30 


48 


20 


32 


0B 11 


0B 


11 


31 


49 


20 


32 


0C 12 


OC 


12 


32 


50 


16 


22 


od 13 

0E 14 


0D 


\i 


M 


51 


20 


32 


0E 


52 


20 


32 


OF 15 


OF 


15 


35 


n 


20 


32 


10 16 


10 


16 


36 


20 


32 


11 17 


11 


17 


37 


55 


04 


4 


12 18 


12 


18 


38 


56 


20 


32 


13 19 
}k 20 


13 


19 


39 


57 


20 


32 


20 


32 


3A 


58 


20 


32 


15 21 


20 


32 


3B 


59 


20 


32 


16 22 


08 


8 


3C 


60 


14 


20 


17 23 

18 2k 


20 


32 


3D 


61 


15 


21 


18 


24 


3E 


62 


20 


32 


19 25 


19 


25 


11 


il 


1A 


26 


1A 26 


20 


32 


20 


32 


1B 27 


20 


32 


41 


65 


20 


32 


1C 28 


1C 


28 


42 


66 


20 


32 


1D 29 


1D 


29 


a 


67 


20 


32 


1E 30 


1E 


30 


68 


20 


32 


1F 31 


1F 


31 


it 


69 


20 


32 


20 32 


20 


32 


46 


70 


20 


32 


21 33 

22 Ik 


20 


32 


47 


71 


20 


32 


1C 


28 


48 


72 


20 


32 


2 ? 3 £ 
2k 36 


20 


32 


49 


a 


20 


32 


20 


32 


4A 


9B 


'8 


25 37 


0A 


10 


4B 


75 


2E 
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EBCDIC 


ASCI I 


EBCDIC 


ASCI 1 


VALUE 


= VALUE 


VALUE 


= VALUE 


HEX DEC 


HEX 


DEC 


HEX 


DEC 


HEX DEC 


4C 76 


3C 


60 


7D 1 


25 


27 39 


4D 77 


28 


40 


7E 1 


26 


3D 61 


4E 78 


2B 


43 


7F 1 


27 


22 34 


4F 79 


B3 


1 ?9 


80 1 


28 


20 32 


50 80 


26 


38 


81 1 


29 


61 97 


51 81 


20 


32 


82 1 


30 


62 98 


52 82 


20 


32 


U\ 


31 


63 90 

64 100 


\i u 


20 


32 


32 


20 


32 


§5 1 


11 


65 101 


55 85 


20 


32 


86 l 


66 102 


56 86 


20 


32 


87 1 


35 


67 103 

68 104 


57 87 


20 


32 


88 1 


36 


58 88 


20 


32 


89 1 


3Z 


69 105 


59 89 


20 


32 


8A 1 


38 


20 32 


5A 90 


21 


33 


8B l 


11 


7B 123 


5B 91 


2k 


11 


8C 1 


F3 243 


5C 92 


2A 


8D 1 


41 


20 32 


5D 93 
5E 94 


29 


41 


8E ' 


42 


20 32 


3B 


59 


8F 1 


K 


C5 197 


5F 95 


AA 


170 


90 1 


20 32 


60 96 


2D 


7*5 


91 1 


45 


6A 106 


61 97 


2F 


46 


92 1 


46 


6B 107 


62 98 


20 


32 


Ii! 


47 


6C 108 


63 99 

64 100 


20 


32 


48 


6D 109 


20 


32 


95 


49 


6E 110 


65 101 


20 


32 


96 i 


50 


6F 110 


66 102 


20 


32 


97 


51 


70 112 


67 103 

68 104 


20 


32 


98 1 


52 


71 113 

72 114 


20 


32 


99 


M 


69 105 


20 


32 


9A 1 


20 32 


6A 106 


7C 


124 


9B 


55 


7D 175 


6B 107 


2C 


44 


9C 


56 


20 32 


6C 108 


25 


37 


9D 


57 


20 32 
F1 241 


6D 109 


5F 


95 


9E 


58 


6E 110 


3E 


62 


9F 


59 


FE 254 


6F 111 


3F 


63 


AO 


60 


20 32 


70 112 


20 


32 


A1 


61 


7E 126 


71 113 

72 114 


20 


32 


A2 


62 


73 115 

74 116 


20 


32 


8 


8 


73 115 
Ik 116 


20 


3* 


75 117 


20 


32 


A5 


I65 


76 118 


75 117 


20 


32 


A6 


66 


77 119 


76 118 


20 


32 


A7 


167 


78 120 


77 119 


on 


7 
J*- 


A8 


|£A 


7Q 191 


78 120 


20 


32 


A9 


i69 


7A 122 


79 121 


60 


96 


AA 


170 


20 32 


7A 122 


3A 


58 


AB 


171 


CO 192 


7B 123 
7C 124 


23 


S 


AC 


172 


DA 218 


4o 


AD 


173 


5B 91 
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EBCDIC 


ASCI I 


EBCDIC 


ASCI I 


VALUE 


= VALUE 


VALUE 


= VALUE 


HEX DEC 


HEX 


DEC 


HEX DEC 


HEX DEC 


AE 174 


F2 


242 


D7 


215 


50 


80 


AF 175 


F9 249 


D8 


216 


51 


81 


BO 176 


20 


32 


D9 


217 


52 


82 


B1 177 


20 


32 


DA 


218 


20 


32 


B2 178 


20 


32 


DB 


219 


20 


32 


B3 179 
B4 180 


20 


32 


DC 


220 


20 


32 


20 


32 


DD 


221 


20 


32 


B5 181 


20 


32 


DE 


222 


20 


32 


B6 182 


20 


32 


DF 


223 
224 


20 


32 


B7 183 
B8 184 


20 


32 


EO 


5C 


92 


20 


32 


E1 


225 


20 


32 


B9 185 


20 


32 


E2 


226 


11 


k 


BA 186 


20 


32 


12 


227 


BB 187 


D9 


217 


228 


55 


§5 


BC 188 


BF 


191 


E5 


229 


56 


86 


BD 189 


5D 


93 


E6 


230 


57 


87 


BE 190 


20 


32 


E7 


231 


58 


88 


BF 191 


C4 


196 


E8 


232 


59 


89 


CO 192 


7B 


123 


E9 


233 
23h 


5A 


90 


C1 193 
C2 194 


41 


65 


EA 


20 


32 


42 


66 


EB 


235 


20 


32 


C3 195 

c4 196 


n 


67 


EC 


236 


20 


32 


68 


ED 


237 


20 


32 


C5 197 


45 


69 


EE 


238 


20 


32 


C6 198 


46 


70 


EF 


239 
240 


20 


11 


C7 199 


47 


71 


FO 


30 


C8 200 


48 


72 


F1 


241 


31 


49 


C9 201 


49 


73 


F2 


242 


32 


50 


CA 202 
CB 203 
CC 204 


20 
20 


32 
32 


s 


243 
244 


11 


51 
52 


20 


32 


F5 


245 


1$ 


11 


CD 205 


20 


32 


F6 


246 


36 


CE 206 


20 


32 


F7 


247 


37 


55 


CF 207 


20 


32 


F8 


248 


38 


56 


DO 208 


7D 


'% 


F9 


249 


39 


57 


D1 209 


4A 


FA 


250 


20 


32 


D2 210 


4B 


75 


FB 


251 


20 


32 


D3 211 
D4 212 


4C 


76 


FC 


252 


20 


32 


4D 


77 


FF 


253 
254 


20 


32 


D5 213 
D6 214 


4E 


78 


FE 


20 


32 


4F 


79 


FF 


255 


20 


32 
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The VM/PC programs use the following table when in 
3278/3279 Emulation Mode to translate ASCII format data to 
VM/PC CMS EBCDIC format data whenever necessary. 



ASCI 1 


EBCDIC 


VALUE 


= VALUE 


HEX 


DEC 


HEX 


DEC 


00 





00 





01 


1 


01 


1 


02 


2 


02 


2 


°ol 


i 


03 


3 


37 


n 


05 


5 


2D 


06 


6 


2E 


46 


07 


7 


2F 


47 


08 


8 


16 


22 


09 


9 


05 


5 


0A 


10 


25 


37 


0B 


11 


0B 


11 


OC 


12 


OC 


12 


0D 


\l 


0D 


\i 


0E 


0E 


OF 


15 


OF 


15 


10 


16 


10 


16 


11 


17 


11 


17 


12 


18 


12 


18 


\i 


19 


13 


J9 


20 


3C 


60 


15 


21 


3D 


61 


16 


22 


32 


50 


17 


11 


26 


38 


18 


18 


24 


19 


2 5 


19 


?5 


1A 


26 


3F 


63 


1B 


27 


27 


39 


1C 


28 


1C 


28 


1D 


29 


1D 


29 


1E 


30 


IE 


30 


1F 


31 


1F 


3, 1 


20 


32 


4o 


64 


21 


*5 *) 


5A 


90 


22 


7F 


127 


n 


35- 


7B 


123 


36 


5B 


9 1 


25 


37 


6C 


108 


26 


38 


50 


80 



ASCI I 


EBCDIC 


VALUE 


= VALUE 


HEX DEC 


HEX DEC 


27 


11 


7D 125 


28 


4D 77 


29 


41 


5D 93 


2A 


42 


4E 78 


2B 


a 


2C 


6B 107 


2D 


45 


60 96 


2E 


46 


4B 75 


2F 


47 


61 97 
FO 2^0 


30 


48 


31 


49 


F1 241 


32 


50 


F2 242 


a 


51 
52 


F3 243 


35 


11 


F5 245 


36 


F6 246 


37 


55 


F7 247 


38 


56 


F8 248 


39 


57 


F9 249 


3A 


58 


7A 122 


3B 


59 


5E 94 
4C 76 


3C 


60 


3D 


61 


7E 126 


3E 


62 


6E 110 


3F 


U 


6F 111 


40 


7C 124 


41 


65 


C1 193 
C2 194 


42 


66 


S 


67 


C3 195 
C4 196 


68 


i»5 


69 


C5 197 


46 


70 


C6 198 


47 


71 


C7 199 


LH 


72 


C8 200 


49 


?? 


C9 201 


4A 


D1 209 


4B 


75 


D2 210 


4C 


76 


D3 211 
D4 212 


4D 


77 
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ASCI I 

VALUE 

HEX DEC 



EBCDIC 

VALUE 

HEX DEC 



ASCI I 

VALUE 

HEX DEC 



EBCDIC 

VALUE 

HEX DEC 



4E 
4F 
50 
51 
52 

u 
u 

59 
5A 
5B 
5C 
5D 
5E 

15 

61 
62 



78 

P 
80 

81 

82 

U 

u 

87 

88 

89 

90 

91 

92 

9 

9 

9 £ 
96 

3 l 
98 

99 

64 100 

65 101 

66 102 

67 103 

68 104 

69 105 
6A 106 
6B 107 
6C 108 
6D 109 
6E 110 
6F 111 

70 112 

71 11 

72 11 

73 115 

74 116 

75 117 

76 118 

77 119 

78 120 

79 121 
7A 122 
7B 121 
7C 124 
7D 125 
7E 126 



D5 211 
D6 214 
D7 215 
D8 216 
D9 217 
E2 226 
E? 227 
E4 228 
E5 229 
E6 230 
E7 231 
E8 232 
E9 233 
AD 173 
E0 224 
BD 189 
5F 95 
6D 109 
79 121 

81 129 

82 130 

83 131 



84 132 

& 13 ? 

86 134 

87 135 

88 136 

89 137 

91 145 

92 146 

93 147 

94 148 

95 149 

96 150 

97 151 

98 152 

99 153 
A2 162 
A3 16 
A4 16 
A5 165 
A6 166 
A7 167 
A8 168 
A9 169 
8B 139 
6A 106 
9B 155 
A1 161 



7F 
80 
81 
82 

u 

87 
88 

P 
8A 

8B 

8C 

8D 

8E 

8F 

90 

91 

92 

9 

9 

9 £ 
96 

3 l 
98 

99 

9A 

9B 

9C 

9D 

9E 

9F 

AO 

A1 

A2 

8 

21 

A7 
A8 
A9 
AA 
AB 
AC 
AD 
AE 
AF 



27 


07 


7 


28 


00 





29 


00 





30 


00 





31 


00 





32 


00 





11 


00 





00 





35 


00 





36 


00 





37 


00 





38 


00 





11 


00 





00 





41 


00 





42 


00 





a 


00 





00 





45 


00 





46 


00 





47 


00 





48 


00 





49 


00 





50 


00 





51 


00 





52 


00 





8 


00 





00 





55 


4A 


74 


56 


00 





57 


00 





58 


00 





59 


00 





60 


00 





61 


00 





62 


00 





a 


00 





00 





65 


00 





66 


00 





67 


00 





68 


00 





69 


00 





70 


5F 


95 


71 


00 





72 


00 





?J 


00 





00 





75 


00 
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ASCI 1 


EBCDIC 


ASCI I 


EBCDIC 




VALUE 


= VALUE 


VALUE 


= VALUE 




HEX DEC 


HEX 


DEC 


HEX DEC 


HEX DEC 




BO 176 


00 





D8 


216 


00 





ft 


B1 177 


00 





D9 


217 


BB 


187 




B2 178 


00 





DA 


218 


AC 


172 




B3 179 
B4 180 


4F 





DB 


219 


00 







00 





DC 


220 


00 







B5 181 


00 





DD 


221 


00 







B6 182 


00 





DE 


222 


00 







B7 183 
B8 184 


00 





DF 


223 
224 


00 







00 





EO 


00 







B9 185 


00 





E1 


225 


00 







BA 186 


00 





E2 


226 


00 







BB 187 


00 





11 


227 


00 







BC 188 


00 





228 


00 







BD 189 


00 





E5 


229 


00 







BE 190 


00 





E6 


230 


00 







BF 191 


BC 


188 


E7 


231 


00 







CO 192 


AB 


171 


E8 


232 


00 







C1 193 
C2 ]3k 


00 





E9 


233 
234 


00 







00 





EA 


00 







C3 195 

c4 196 


00 





EB 


235 


00 







BF 


191 
143 


EC 


236 


00 







C5 197 


8F 


ED 


237 


00 







C6 198 


00 





EE 


238 


00 







C7 199 


00 





EF 


239 
240 


00 







C8 200 


00 





FO 


00 







C9 201 


00 





F1 


241 


9E 


158 




CA 202 


00 





F2 


242 


AE 


174 




CB 203 
CC 204 


00 





a 


243 
244 


8C 


140 




00 





00 







CD 205 


00 





F5 245 


00 







CE 206 


00 





F6 


246 


00 







CF 207 


00 





F7 


247 


00 







DO 208 


00 





F8 


248 


A1 


161 




D1 209 


00 





F9 


249 


AF 


175 




D2 210 


00 





FA 


250 


00 







D3 211 
D4 212 


00 





FB 


251 


00 







00 





FC 


252 


00 







D5 213 
D6 214 


00 





FF 


253 
254 


00 







00 





FE 


9F 


159 




D7 215 


00 





FF 


255 


00 
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Appendix E. Distribution Diskette 
Contents 



All seven of the VM/PC Distribution Diskettes are double-sided, 
double-density and write-protected. 

The DOS files shipped on each diskette are shown in the 
following table: 



Diskette File Name 

* INSTALL.BAT 
VMPCLOGO.BAS 

VMPCNB.BAT 

* VMPCOO.MSG 

* VMPC02.BAS 

* VMPC02.MSG 
VMPC04.BAS 

* VMPC04.MSG 

* TVMPCHD.MSG 
TVMPC01.BAS 

* TVMPC01.MSG 

* TVMPC03.BAS 

* TVMPC03.MSG 



File Description 

Batch file that begins installation 

Installation program that presents 

logo screen 

Batch file that issues VMPCOO 

message 

Installation message - No DOS 

faci 1 i ties 

Installation program that issues 

VMPC02 message 

Installation message - Found 

temporary f i les 

Installation program that issues 

VMPC04 message 

Installation message - Preliminary 

Check ok 

Installation message header 

Installation program that issues 

TVMPC01 message 

Installation message - Completion 

Installation program that issues 

TVMPC03 message 

Installation message - Did not 

complete 



Figure E-l (Part 1 of 2). Distribution Diskette Contents 
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Disket 


te File Name 


1 /'c 


VMPCLC.BAT 


J ~ 


VMPCLX.EXE 


1 /C 


TVMPCDD2.BAS 


J * 


TVMPCDD3.BAS 


1 * 


TVMPCDD4.BAS 


1 /'? 


TVMPCDD7.BAS 


J * 


VMPCDEL.BAT 




CMS. 101 


2 


CONFIG. 1VM 


2 


VMPC.COM 


2 


CPI0.1VM 


2 


CP.1VM 


2 


CPMSG.1VM 


2 * 


VMPCDEL.BAT 


2 


CPIO.SYM 


3 


CMS.1VM 


3 


CMS. 101 


3 * 


VMPCDEL.BAT 


4 


CMS. 100 


5 


CMS. 100 


6 


CMS. 100 


7 


CMS. 100 


7 * 


TVMPC.100 


7 


VMPCCON.EXE 


7 * 


VMPCDEL.BAT 



File Description 

Batch file that continues 

instal lat ion 

Installation program that lists 

exi st i ng f i les 

Program that installs diskette 2 

f i les 

Program that installs diskette 3 

f i le 

Program that installs file from 

diskettes 4, 5 5 6, and 7. 

Program that installs file from 

diskette 7. 

Batch file that ends installation 

VM/PC Host Server source minidisk 

VM/PC Configuration f i le 

VM/PC Program 

VM/PC Control Program 1/0 Services 

VM/PC Control Program 

VM/PC Control Program Message file 

Batch file that ends installation 

Symbol Table used as Service Aid 

VM/PC CMS Program 

VM/PC Host Server Installation 

mi n i d i sk 

Batch file that ends installation 

VM/PC CMS Library minidisk (part 1 

of k) 

VM/PC CMS Library minidisk (part 2 

of k) 

VM/PC CMS Library minidisk (part 3 

of k) 

VM/PC CMS Library minidisk (part k 

of k) 

Temporary file 

VM/PC Configurator Program 

Batch file that ends installation 



Figure E-l (Part 2 of 2). Distribution Diskette Contents 

The '*' indicates files used only during installation. 

A CMS. 101 file appears on both Distribution Diskette 1 and on 
Distribution Diskette 3. Although they have the same name, they 
do NOT contain the same data. 
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The CMS. 101 file on Distribution Diskette 1 is a VM/PC CMS 
minidisk containing several source programs (in packed format) 
for the Host Server. 

The CMS. 101 file on Distribution Diskette 3 is a VM/PC CMS 
minidisk containing the EXECs and other programs needed to 
install the Host Server on the host system. 
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Glossary 



The following is a list of terms and 
acronyms used in this book and an 
explanation of their meaning. 
Glossaries with further definitions can 
be found in the Personal Computer 
Hardware Reference Library 
publication BASIC, and in the Virtual 
Machine/System Product Library 
publication Library Guide and Master 
Index, order number GT00-1356. 

ASCII. American National Standard 
Code for Information Interchange. A 
standard code used for exchanging 
information among data processing 
systems and associated equipment. An 
ASCII file is a text file where the 
characters are represented in ASCII 
codes. 



CMS. Conversational Monitor 
System. The component of VM/PC 
that provides the user with an 
application interface within the Local 
Session. CMS functionally resembles 
the similarly named component of the 
IBM Virtual Machine/System Product 
(VM/SP). 

CP. Control Program. The 
component of VM/PC that intercedes 
between CMS and the hardware 
system. CP functionally resembles the 
similarly named component of the 
IBM Virtual Machine/System Product 
(VM/SP). 

cursor. A moveable marker that 
indicates a position on the display. 



backup. Pertaining to a system, 
device, file, or facility that can be used 
in case of a malfunction or loss of 
data. 

block. The unit of data physically 
read/written by VM/PC CMS when 
performing I/O to a minidisk. 

buffer. An area of storage that is 
used to compensate for a difference in 
rate of flow of data, or time of 
occurrence of events, when 
transferring data from one device to 
another. Usually refers to an area 
reserved for I/O operations, into 
which data is read or from which data 
is written. 

Configurator. A VM/PC program 
that helps the user specify and edit the 
parameters and data that are stored on 
the VM/PC Configuration file. 



default. A value or option that is 
assumed when none is specified. 

delimiter. A character that groups or 
separates words or values in a line of 
input. 

DOS. The IBM Personal Computer 
Disk Operating System (Version 2.10 
or its equivalent). VM/PC on a 
Personal Computer AT/370 requires 
DOS version 3.00. 

download. The process of transferring 
a file from a host computer to a local 
computer. See also 'Upload'. 

EBCDIC. Extended Binary-Coded 
Decimal Interchange Code. A coded 
character set consisting of 8-bit coded 
characters. 

edit. To enter, modify, or delete data. 



Glossary X-l 



environment. A program, loaded by 
VM/PC CP, which operates in the 
370 virtual machine. CMS is an 
environment. 

export. The process of creating a 
Personal Computer DOS file from 
data stored on a CMS file. See also 
'import'. 

EXEC. A CMS file with a filetype of 
EXEC. It contains a series of 
statements that are all executed when 
you enter the filename of the EXEC 
file. 

file. A collection of related records, 
treated as a unit. To VM/PC CMS, a 
file has a unique three-part label. The 
first part of the label is the 'filename'. 
The second part is the 'filetype'. And 
the third part is the 'filemode'. 

filemode. The third part of the label 
of a VM/PC CMS file. It indicates 
the minidisk on which the file resides. 

filename. The first part of the label of 
a VM/PC CMS file. 

filespec. The name of a Personal 
Computer DOS file in a form 
acceptable to Personal Computer 
DOS. Usually of the form 
d:filename.ext. 

filetype. The second part of the label 
of a VM/PC CMS file. Some 
filetypes (for example, ASSEMBLE 
and EXEC) imply that the file has 
certain characteristics. 



host session. A connection, over 
either a coaxial cable or an 
asynchronous communications line, 
between a VM/PC user and a 
separate computer. 

import. The process of creating a 
CMS file from data stored on a 
Personal Computer DOS file. See also 
'export'. 

Kilobyte (K). 1024 bytes. 

local session. A session running in the 
370 virtual machine of your Personal 
Computer model XT/370 or AT/370. 

Megabyte (M). 1,048,576 bytes 
(1024 K). 

menu. A list of available operations. 
You select the operation you want 
from the list. 

minidisk. A Personal Computer DOS 
file that is managed by VM/PC as a 
logical disk drive. A minidisk, itself a 
single Personal Computer DOS file, 
can contain numerous CMS files. 

null entry. A response, to a prompt, 
consisting only of pressing the 
ENTER key. 



PC DOS. See DOS. 



personality file. The Personal 
Computer DOS file containing the 
information needed to fully activate 
the Personal Computer model 
XT/370 or AT/370 hardware. 



function key. One of the ten keys 
labeled Fl through F10 on the left 
side of the keyboard. In VM/PC, 
these are equivalent to PF 1 through 
PF 10, and PF 1 1 is the shift key and 
Fl, and PF 12 is the shift key and F2. 

Host Services Program. A program 
that enables you to use the resources 
of a Host VM/SP system. 



PF key. See function key. 

prompt. A question the computer 
asks when it needs you to supply 
information. 

queue. A line or list of items waiting 
for service; the first item that went in 
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the queue is the first item to be 
serviced. 

record. A collection of related 
information, treated as a unit. For 
example, in stock control, each invoice 
might be one record. 

REXX. The Restructured Extended 
Executor language used to write 
EXECs to be handled by the System 
Product Interpreter. 

scroll. To move all or part of the 
display image vertically or horizontally 
so that new data appears at one edge 
as old data disappears at the opposite 
edge. 

session. A connection between a user 
and a computer. 

spooling. A method of printing files 
while concurrently continuing with 
other activities. 



upload. The process of transferring a 
file from a local computer to a host 
computer. See also 'download'. 

USERID. User identification. The 
name by which VM/PC knows 
someone allowed to use the Local 
Session. Sometimes referred to as a 
"logonid." 

VMPCSERV. The VM/PC Host 

Services Program. 

VM/PC. The IBM Virtual 
Machine/Personal Computer licensed 
program. 

VM/SP. The IBM Virtual Machine / 
System Product 

XEDIT. The VM/PC CMS file 
editor program. XEDIT functionally 
resembles the VM/SP System Product 
Editor. 
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* 7-12 

#CP 7-12 

abbreviating 7-3 

ACCESS 6-1,7-84 

ATTN 7-14 
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DEBUG 7-95 
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MACLIB 7-147 
MAKEBUF 7-148 
MODMAP 7-149 
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UPDATE 7-183 

VMPC 4-1 
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VMPCSERV 6-10 

working with 5-1 

XEDIT 7-184 
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VM/SP B-l 
CONFIG.SYS file C-4, C-5 
CONFIG.UT1 3-3, 3-23 
CONFIG.1VM file 2-10, 2-23, 3-3, 
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configuration limitations 3-23 
configurator 3-2 
Configurator - definition of X-l 
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system 1-12 
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CP command summary 7-9 
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CMS Maclibs B-4 
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initialization B-2 
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SVCTRACE B-6 

SYSPROF EXEC B-2 
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TERMINAL command B-3 

virtual punches B-l 
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XEDIT B-5 

Y disk B-2 
directories, tree-structured C-7 
DISK B-7 

diskette contents, distribution E-l 
diskettes 

CMS 2-11 



X-6 VM/Ft Users Guide 



control program 2-9 

installation 2-1 

library 2-13 
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HARDWARE ERROR 
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HEXIN module 6-9 
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highlighting input 5-61 
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